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BxEPLAY LxeTe 


eo Jeeta Ce. cer 


Several seetings ago | spoke briefly on the nature of display 
lists. 1 did not atteapt to esate a complete description of 
all of the hows and whys of display lists in the hope that 
soe of you would try to use thee and experi@ent on your own. 
On looking back on it I think that 1 was a bit hasty in ay 
coverage of sone of the aspects of the display list. Mow that 
1 ae again actively prograsaing, | would lite to try to 
elaborate a bit on ay earlier discussion, ~ 


First, remeaber that a display Jist 18 basically a set of 
instructions that tell the AMTIC chip how to set up the 
screer. In addition to telling AMTIC hon to set up the 
screen, it tells AMTIC what eeaory locations should be 
displayed on the screen. It 18 possible to display any area 
of seaory that you mish on the screen. You can even put your 
BASIC cartridge on the screen once you learn to fiddle mith 
the display list. 


Please refer to the GRAPHICS @ display list that accoapanies 
this article as | explain the structure of the display list 
(Fig. 1). 


To find your display list, type: 
DL=PEEK (566) +256 ePEEK (541) 


Nesory locations 568 and 561 are pointers to the display 
list. They tell AMTIC where to find the display list an 
eesory. 


The first three bytes of the display list (DL+8, Ditl, B+2) 
ace 112,112,112. Each “112° instruction causes B blank scan 
lines to be printed. These instructions cause a border to be 
printed at the top of your screen. 


The next byte (DLt3) as the LAS (load eeeory scan) 
instruction byte. Although it appears to we huaans as 66, to 
ANTIC at as really 6492. The 64 tells AMTIC that the next two 
bytes fore the first address of screen seaory. The tao tells 
ANTIC to begin displaying GRAPHICS @ on the screen. 


To calculate the actual starting address of screen seaory, 
try the following: 


SCR=PEEK (DL #4) ¢2540PEEK (DL +5) 
Then clear the screen and type: 


POKE SCR, 255 


S$ 


@ 


A saall inverse pointy character should appear in the first 
byte of screen eeeory, which is at the top left corner of 
your screen. These two display list bytes are the ones that 
you would change to have the coaputer display other areas of 
seaory on the screen. The second nueber (Dith) is the page 
nuaber of screen aesory. Adding | to this nuabder will Cause 
screen eeaory to begin 256 bytes higher in eeeory. Add 8 and 
you'll be displaying a portion of your BASIC cartridge on 
your screen’ 


After the address bytes come 723 twos. Each 2 tells AMTIC to 
display one line of GRAPHICS rero. These 23 plus the one 
hidden in the LAS byte (642) result in 24 Lines of GRAPHICS 
6 being dislayed. 


The instruction 65 tells ANTIC to juep to the address foreed 
by the next two bytes and wait for the vertical blank to end 
before beginning a new sweep of the screen. The address that 
ATIC juaps to 18 the beginning of the display list. These 
two address bytes, therefore, are the sase two nuebers as the 
ones in eeaory locations 568 and 561 (since these sesory 
locations *point® to the display list). 


Since this list of instructions 16 in RAM eeeory, it can be 
@odified. AMTIC will faithfully follom any changes that you 
gake, so that you can ein graphics @odes at will, provided 
that you adhere to a few siaple rules. 


A prise rule is that the display list cannot be too long, or 
data will be printed below your TV screen, out of sight. Even 
worse things can happen with very long display lists, so care 
gust be taken not to erceed “the sagic nuaber’. The sagic 
nuaber is, of course, 192 scan lines. Reaeaber that a scan 
line 18 a narrow horizontal line across your TV screen. The 
entire screen is 192 scan lines high, so that each display 
list written by the Operating Systee in response to a 
GRAPHICS an comaand has exactly 192 scan lines. (it 1s 
possible to be under 192; going OVER 192 presents problees.) 


In a aode 6 screen, there are 24 horizontal rows of tert. We 
will call each of these 24 rows a ‘aode line’. Therefore, 
there are 24 eode lines in GRAPHICS 8. Since there are 192 
scan lines, it follows that each ode line eust contain 
192/24, or @ scan lines. You probably know that this 1s 
correct, since each character displayed on the screen is 8 
bytes (scan lines) tall. It a8 therefore ieporant to know how 
@any scan lines are in each aode line when you are trying to 
build a display list. Caretul planning will insure that you 
do not exceed 192 scan lines. 


Another requiresent is that you set up enough eesory to hold 
all of the screen data that will be needed in your nem aired 
eode. The @isplay list is located sesediately beiore the 
screen data, which eeans that the screen data 16 sandaiched 


CONTINUED ON NEXT PAGE 


by 


Fiolly Her mers 


Here are afew little ideas in BASIC that | 
useful. 

I like to add one or aore screens of text instructions 
to various utility prograas, etc. te reeind ee of what the 
progres does and how to use it. In order to keep the tert on 
the screen long enough to read it, soee eethod oust be 
eeployed to stop or delay the progras. Mere are soe choices: 

1. Use a delay loop such as; 
16 FOR DELAY<1 to SOO: MEIT BELAY . 


find quite 


This 16 probably one of the first BASIC progressing 
techniques that we all learn. It is alright, but it is 
difficult to get the length of the delay right for everyone 
reading and Comprehension speed. Also sosetices the 
instructions suggest getting a pencil and paper and jotting 
down the pertinent heystotes. Wow can one judge the delay 
tiee to use? 

2. A better approach is to use a eethod which allows the 
user to Continue the prograe whenever he is ready. Here are a 
Couple of ways to accoaplish this: 

a. At the place in your progrea that you want to stop, place 
on IMPUT STATERENT such as; 


3 DIM WOLDS(1) 

16 REA your text 

20 REN goes here 

MO REM and here 

06 ?*press RETURN to continue’; 
90 INPUT WOLDS 

100 REM prograe continues here 


The DIM statesent is mecessary unless you are going to 
use @ auaeric variable and instruct the user to press only a 
nuaber key. But then you would probably need an error TRAP. 
In the above eethod, if you would like to get rié of the 
Question ark when the IMPUT stateent is executed, change 
line % to: 
90 INPUT 014, WOLDS 
b. An even siapler eethod is; 


06 ?*Press any key to continue’ 
96 IF PEEK(7S3)()3 THEN 9 


Neeory location 753 is known as KEYDEL. If it is equal 


to 6, no hey was pressed. If it equals Jthen otey eas 
pressed. 


Try these, 1 think you will like thee. ¢) 


@ 


between the display list and the BASIC cartridge. You oust 
start your display list far enough amay froe BASIC so that 
all of your screen data can fit. This is very easy, however. 
If you know which @odes you would like to use, you can set 
the computer in the highest seeory-consueing aode that you 
have before changing the display list. This will 
autosatically ove the display list lower in eeeory. 
(Reseaber that you will ALWAYS be able to find the display 
list using FEEK(SOO1+ 2560 PEEK(SOI) ), 


Another thing to reaeaber is that although our text sode is 
graphics sode zero, it is ANTIC eode 2. The display list 
therefore contains twos and aot zeroes. You ust always use 
the ANTIC ode nuedber in a display list. The AMTIC eode 
nuabers can be found on page 298 of the blue boot “Your Atari 
Coaputer.* 


Try the following at your coaputer in iseediate aode: 


DL=PEEK (S66) * 2548 PEEK (S61) 
W=6:REM the ANTIC aode @ for GR.1 
POKE DLtlO,W:POKE DLeli,™ 

POKE Ditl2,W:POKE Ditl3,m 


Move the cursor into this area and type to see your sodified 
display list. Try other values of Mita see various other 
effects. Also experiaent mith SETCOLOR 2 and SETCOLOR 4 
stateaents to see their effect on your display. Soee very 
attractive title screens for prograas can be built with a 
ainiaue of fuss by using this technique. [| hope that I have 
been able to add a useful skill to your prograsaing 
repetoire. 


The listing of the 


N=7:REM GRAPHICS 2 display list is at 


W=B8:REAN GRAPHICS 3 the right. ------ ) 
W=1S:REN GRAPHICS 7 
() 

FRR 


SPECIAL EVENTS 


This aonth we extend congratulations to... 


Leon Lazarus, Mario Taccariello, and Gerry Courtade who 


celebrate their birthdays in Deceeder. Best wishes to all. 


All events should be received by the 18th of the eonth 


in order for us to print it ia the W.A.N.D. on tise. 


please send all itees to: WAM. D. 


c/o Rolly Merean 

4 Charlotte Street 
Mite Plains. MY, 
16466 re) 
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FAST FIRE (BUTTON) 
) S1L-Acé pvv BY 
by Gerry Stotte 


Well, a8 promised last issue, here is 
your rapid fire article. You may build 
this into a joystick or use a maie and 
female 9%-pin “—" ( joystick type) 
connector and use it with any joystick. 


You will need ar) NESSS IC no matter which 
version you build (this may have a 
different number in front vis “NE"). 
This iC can be had from Radio Shack for 
$1.19 and elsewhere for about 58 cents. 
This 1s a timer IC. It puts out a 
continuous 'stream' of ones and zeroes if 
connected properly. This can be varied 
by the addition of a pot (or trimpot) 
instead of a'fixed' resistor. Now if 
this if applied to the trigger-in pin of 
the computer, whatever program is running 
thinks you are pushing the fire button 
very rapidly' Now that we know what we 
are duing, let*s continue. 


Figure A shows the "pin-out ” of the 555 
IC. This is a top view (legs down, dot 
or notch on top). This is just so you 
knOw how the pins are numbered. 

(Continued on next page) 
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WTA MY ATAdl tae ! 


®D 


"Go ahead and sue! it's your 
Computer's word against ow 
computer's word!” 


FAST FIRE 
Continued... 


Maring a Standard “Fast Fire" 


Figure & stews how te wire the IC with a 

tale and female connector. If you sere 
going to use this method, you will need a 
male 9-pim "D" connector (Radio Shack - 
411.99) and a female 9-pin “D" connector 

(Racic Shack - $2.49). I suggest you use 
ctiff wire and wire all pins of the male 
back to back with the female with the 
exception of pin 6. Wire the pins fairly 

close together (sa female connector can 
go into computer and male 1s then facing 

out t6 accept a joystick). If you do 
this your fast fire will be quite short 

anc won't Cause the joystick connector to 

Stich out from the computer very far 

{this is what 1S wrong with the 

commercial versions of this circuit). If 

you use this suggested method, you will 

be forced to wire your IC “dead bug” 

style. This means to mount the IC on top 
uf your connectors (a little cement here 
will he:p) with the legs facing up. If 

you don’t like working with the IC upside 
Sowr, CCAREFULLY bend the legs out 
straight and glue 1t down right side up. 

Use “wire wrap" wire (28 or 38 gauge 
wire... very small) todo the pin 2 to 

pin 6 short. Use this fine wire to wire 
pin 3 of the IC to pin 6 of the 

female connector, and pin 1 of the IC to 
pin 6 of the male connector. Then fit 

the rest of the components around this 

anc carefully solder them to the IC. 

Consult the pacts list at the end of this 

article for values etc. 


Another method of mounting would be to 
make ax extension cable for your joystick 
with this mod somewhere in the middle. 
The disadvantage here 18 that your IC and 
your speed acjust pot (variable resistor) 
wild probably end up on the floor most 
of the time... not very handy! 


Making a Joysticnx “Fast Fire” 


This method 18 a little cheaper but nas a 
great cisadvantage: you're stuck with 
using it in one joystick. Refer to 
Figure C. Notice that wath the addition 
(Continued in next column) 


Novesber 


of a toggle Swatch, you can flip from 
“Fast Fire” to normal joystick operation. 
This ewitcn should be a single pol 
Gouble throw switch (SPDT). Tne cente 
pin goes to pin 6 of tne 9-pin connector. 
To build this version you may want to use 
a small piece of “perf board". This is 
Circuit board material with a bunch of 
holes drilled in it (also available from 
Radio Shack). This may or may not be to 
your advantage due to the spare soace 
inside your joystick. 


As with the "Standard Fast Fire” you will 
wart to use 28 or 38 gauge wire to hook 
this up (per Figure C). Use * 
multi-meter or other method to determine 
which wire on the fire button goes to pin 
6 of the 9-pin connector. This is 
important so get it right’ 


All vergigns of “Fast Fire". 
PARTS LIST 


Radio Shack # 


IC - NESSS timer 276-1723 
Ci - 180 uF tantalum 276-1436¢ 
Ri - 1088 ohms 1/4W 271-1321 


R2 - 20K ohm pot or trimpot #«# 

Si - SPDT switch 2735-62508 
- male 9-pin “D" 276-1537eeae 
- female 9-pin "Dd" 276-1536e088 


# This 18 a solid tantalum 18 volt or so 
Capacitor. Don't substitute an 
eiectrolytic! 


**# T used a Spectro) model 84-3-10-263. 
This trimpot will be very hard to find 
but 18 the micest little pot I nave seen 
for this particular purpose, especially 
if you build the 2 connector version. 


see This switch i only used on the 
joystick version 


#eee These connectors are used for the 
"Standard Fast Fire", not the joystick 
mounted version. 

(Continued on next page) 
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Continued... 


Please note that the IC 18 heat sensitive 
(like most IC's), so don't hold the 
ssldering iron On it very long' Don't 
use a soldering gun!!! If this is all 
you Nave forget this project. Use an 
iron with @ small tip. 


Remember, wire all pins of the connector 
except pin 6 (standard version) so the 
Joystick will function. Make sure the 
"+" symbol on the capacitor is towards 
the IC (or “-" symbol 18 away from the 
IC) as shown in Figure B and C. Other 
values of trimpot (variable resistor) can 
be used but Ci must then be changed to 
give a good range to the fire rate. If 
you use 2 larger value trimpot you can 
use a smaller capacitor. If you have a 
junmkbox then experiment a little. If you 
want a slower rate you will either need 
tc raise the resistance of Re (pot) or 
Capacitance of Cl. 


Finally, with the Standard Fast Fire, I 
used a small plastic box and cut slots in 
each end and slipped the connectors 
inside (prewired except for pot). This 
box was open on the bottom. With the 
Sprectrol pot, I drilled three small 
holes in this box. I pushed the pot into 
these and glued it then soldered it to 
proper pins. This made a very small 
package. It all measures about 1 1/4 
inches (end of connector to end of 
connector). I made two of these, one 
with the pot on the left and one with the 
pot on the right for ports 1 and 2 on the 
computer ' 


Have fun' Don’t attempt this 
have some soldering or other hacker type 
experience. If you have problems, call 
or write. I*ll try to answer them. Oh 
yes, I used Radio Shack part numbers only 
because they are usually available almost 


unless you 


everywhere. I don’t work for Radio 
Shack. 
I'l] bring these little jewels to the 


November meeting if [I am able to make it. 
See ya there!'' 
(Continued in next column) 
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FRACTALS 
Getting Down to BASICs 
by Richard Kushner - Jace 


JACe 


Anyone who has seen the Atari game “Rescue 
at Fractalus” has probably already been 
exposed to the world of “fractals". It is 
fractal mathematics that is used to 
generate the mountain ranges of this Qame. 
This is a big advance over the idea of 
plotting the mountains coordinate by 
coordinate and then keeping track of the 
movement of @each point as the view shifts. 
From my reading, I have seen how tractals 
are being applied to @iaicking @any 


natural Phenoaena. They have the 
interesting property of retaining their 
general foram as you look at sore and acre 


detailed pieces of them, that is, a8 you 


take @ @ore and more magnitied look at 
thea. 


My interest in fractals was sparked by an 
article and BASIC program in the Septeaber 
"84 issue of BYTE magazine. An Apple 
BASIC progras was presented that peraits 
one to see how fractal patterns are 
generated. I reter you to that article 
for an explanation of what the program 
does. Most of the work with fractals is 
done on very power ful (i@., Cray) 
Computers and displayed on screens with at 
least 18900X1868 resolution (as opposed to 
the Atari’s 320X196 resolution in GRAPHICS 
6). But it is still fun to play around 
with these things and try out a variety of 
inputs to see what interesting patterns 
can be gener ated. 


My adaptation of the program is given 
bel ow. I’ve used GRAPHICS 8 ta give the 
@ost possible space to plot points. The 
user inputs four numbers: LAMBDA (X,Y) 
which describes the fractal to be plotted, 
SCALE which detersines how large the 
figure will appear on the screen and 
NUMBER which tells the computer how many 
points to plot. The text window at the 
bottom of the screen shows a running count 
of the nuaber of points plotted. It is 
generally best to start with a SCALE value 


around 4, trying other values to plot 
interesting figures on a larger scale. 
Smaller SCALE values mean higher 


magnification. If the «magnification is 
too large, many points will fall off the 
screen. The prograa@ takes care of values 
too large or too seal! to plot in lines 
6002-6088, where these points are plotted 
on the screen edges. If your plots are 
flattened on their outer extremities, use 
@ larger SCALE value. I also had to use 
the ABS function in lines 1828 and 1838 to 
prevent “negative squareroot” errars from 
crashing the progr aa. 


Also shown below are three respesentative 
plots and the LAMBDA (X,Y) values that 
were used to generate thee. The first 
actually has a name, the dragon, and the 
second is a variation an that theae. The 
bottom one is @ good one to show how the 
detail sees in the larger Pieces 
propagates down to the saallest pieces you 
can see. I plotted 18,086 points to get 
these figures and this took quite a while 


Wer sy 
(more than one hour @e".1). Qne hundred 
POInts doesn’t show “Up enough detail, but 
@® couple of thousand points is really 
Sufficient. Because the figures are 
pretty regular, with a degree of 
randoaness, many points end up getting 
plotted and repiotted many ties. I 
encourage you to play around with this 


program and explore the world of fractals 
an the Atari Computer . 


Next month, we’l) QO back to explore the 
SINESCAPE prograa of last aonth. we'll 
show any interesting variations oan the 
program that I happen to have sent to ae 
and see if we can create some of our own. 


19 REM FRACTAL PROGRAM BY GREG TURK 
26 REM FROM BYTE/SEPT °84 

3@ REM MODIFIED FOR THE ATARI 

4@ REM BY RICHARD KUSHNER -JACE 

3@ CX=160:CyY=86 

68 X=8.50661:Y=<8 

168 GOSUB 5eee 

118 GRAPHICS 8:POKE 752,1:COLOR 1 
12@ FOR 1=1 TO 19:GOSUB 4000:NEXT I 
148 BOSUB 4696 

158 BOSUB 46806 

155 COUNT=COUNT+1 

136 IF COUNT=NUMBER THEN PRINT “ALL DO 
WE! !*'!'": END 


1008 REM SQUARE ROOT OF X,Y 
1965 T=y 

1816 S=SOR (KeXxevey) 

1028 Y=SOR(ABS((-xX+S)/2)) 
193@ X=S5QR (ABS ((xX+5)/2)) 
1640 IF 1<@ THEN X=-x 

185@ RETURN 

2000 REM FOUR OVER L 

2018 S=_XeLXeL_VeL_y 

2028 L.xX=4eLx/S 

28368 LY=-4eLy/S 

2848 RETURN 

3008 REM X,V TIMES L 

3SO1B TX=X:Ty=yv 

3828 X=TKeLxX-TYeLy 

3O3SO VY=TKeLyY+TveLx 

3846 RETURN 

4900 REM FUNCTION OF X,Y 
4818 GOSUB 38008 

4620 X=1-x 

4038 GOSUB 1600 

4040 IF RND(@)<@.5 THEN X=-X:Y=-y 
40350 X=1-x ‘ 

4068 K=X/2:V=Y/2 

4878 RETURN 

3008 REM GET VALUES 

53818 GRAPHICS @ 

3628 7? “WHAT IS LAMBDA? (X,Y) “i: INPUT 


3040 7 “WHAT I6 SCALE “3: INPUT SC 
S@3@ 8C*2eCX/SC 
3868 PRINT “NUMBER OF POINTS TO PLOT“; 


6061 XX=SCe(X-@.5) +CX: YY¥=CY-SCeY 
6002 IF XX<@ THEN KX=6@ 

6004 IF YY<® THEN YY=8 

6006 IF KXD319 THEN XX=319 

6008 IF YY>159 THEN YY=159 

6818 PLOT XXK,YY 

6828 RETURN 
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JUNPING BETWEEN PLAYFIELD AND 
PLAYER/MISSILE COORDINATES 


by Gerry Wick 


Recently | wrote a prograa in 
which | needed to know the exact 
Correlation between coordinates in 
Graphics Mode 0 and Player/Missile 
Graphics. Every BASIC progranaer 
=knows that Mode 0 has 40 coluans and 
24 roms. It way not be so well known 
that Player/Missile Graphics has 256 
coluans and 128 rows in double-line 
resolution. (Sose of thea are off the 


The listing 1s for double-line 
resolution, single-width players. The 
horizontal () coordinate tor the 
plaver 1s positioned at its bit 3. 
which 1s the center of the player in 
aost applications. When RUN, the 
program will display a coordinate 
Systea in Mode 0. The player appears 
asa Short bar (or dot) and can be 
eoved with the joystick. 


The coordinates of the player 
appear as text on the screen with ‘kL 
position® tor horizontal coordinate and 
"Y¥ position” tor vertical coordinate. 
Then the player can be lined up with 
the Node 0 coordinates and coaparisons 


the two coordinate systeas. To convert 
these equations to other araphic modes 
1S easy, 
ratio between the nusbers of coluans 
and roms in Mode 0 and all of the other 
text and araphics aodes. 


There is a Straighttormard 


If you are ambitious you can 


figure out a way to eodify this proaras 
so that the equations are automatically 
calculated and olctted on the screen. 
thereby avoiding plotting the equations 
by hand, 
know tow to use the collision reaisters 
in order to do it. 


Warning: vou will need to 


ice 


FOR PLAYERS 

210 POKE 54279,J 

220 PMBASE=2548J 

230 POKE 559,46:REN ENABLE P/N 

240 POKE 53277,3:REM TURN ON PLAYERS 
“30 PORE 704,60:REM PLAYER COLOR 

260 1=120; ¥=60 

270 FOR J=PMBASE+S12 10 PMBASE +640; POKE 
1,O;:WELT [:REM CLEAR PLAYER 

280 ST=STICb (0) 

240 

Make (ST=7) + (MC 205); MeN (STA bd - (0010) 
SOO POKE =53248.1;REN MOVE PLAYER 
HORI 2ONTALL ¥ 

310 
ve¥e(ST=13)¢(4C 1200s ¥24-(ST=14)-1 995) 
31S RESTORE 330 


320 FO 1=PNBASE +51 2¢¥-1 10 


Acé<o Avov ZY G: 


LET’S TALK CONTROL 


(Hepnnt The Escape 


Little Rock Atati Addicts) 


About once 4 year, whether | need to of Not | enter DOS and rename 
a file to 4 filename alieady existing On the dish If you've ever done 
this yOu know whal the problem is You've got two files on the same 
disk, DOIN with tne same tiename if you try tu Change one, DOS 
Changes both If you try to delete one, DOS deletes boin Ii you try to 
load Once, yOu Only get One bul i's the bitst One in the difectory 

Is there a way tu recover the other tie? The answer is yes [he pro 
gram listed below 1s called AL TEADIR (alte: dwectory) tt will stead the 
dish Gitectory Gwectly trom the disk (without the neip of OS) allow 
you to Change any filename and write the altered directory back Out 
to the disk Phe machine language Subsouline in the program 1s a disk 
Nandlet allowing yOu tu Jo.) Kinds OF Inings lo disk data In ins Case 
ibis set up to read the 6 sectors Of the dish diectory Aller you Nave 
entered yout Changes the POKE on Line 20/0 changes the ML rouline 
tu witte Ihe dwectory Udla back to the disk 

This 1s nol 4 progiam you'll Need every day bul the day yOu Ju 


you'll be yled it's around 


ALT ER) 


Jonny David McF atland 


1000 If ¥:66 Of ¥-98 Imem PRIGI asc 


Tasiteiemys, ze 16% 5))¢2S5e"asc (oorAs (3: 
#5, 391685)) 


: 1 MEM) IMIS ROUTINE ALLOMS Ime usta T 1083 J: 4th 
screen and out of our rarge of vision.) can be sade. Their relationship shen ape tg 1---.2 PABASE+SI2¢yei:READ A:POKE =, A: NELI i 1090 FL-FLOL: IF FLCL? mem Le6e 
But how do they overlap? To coaplicate plotted on a raph follows the rn . | I:REN MOVE PLAYER VERTICALLY 2 MEM) CHANCE IME FILE RAPE OF moRmML 1110 POS.1,22:PRIMI“Type entry @ or 
matters, | understand that each TV or equation: ore 330 DATA 0.8.0 J REM) DISK FILES. Tt R€00S ane mite Eleas) “; 605 KEY 
monitior has its = own unique K(P/M) = 49010) 45 “n | é $46 POSITION 5,4:PRINT X;" *: POSITION REM) OIRECTLY FROM & 10 Ime O15 r00e tides eee 
Quaok t Wows ' Bina ‘ 
characteristics, mere L(P/N) 4s the — horizontal wes Sovacnnel P 28, 4:PRINT Y; ie SR silk Geer iii “cai 
Coordinate in Plaver/Missile Graphics $30 6010 280 cei are int saan 1007 ttn 

et ct eee ee a NL Ried i ayleiwne: ania ets 2g 2020 (Rar 40: PRint Cumsc172S) :Paiart 
ever want to know such inforaation. Vertical direction the equation 1s: EDITOR'S NOTE: Plaver-eissile araphacs 10 KEY 98 wie Wit sibohs tak Quilnas 
Suppose that in a program you are VIP/M) = 40¥(0) ¢ 17 10 6.100 


writing you want to quide a doo around. 


on the screen with your joystick. You 
created the dog using player/aissile 


To deteraine the equations tor 
double-width plavers, change line 255 


PLAYER/MISSILE CoorpwaTES 


: 
° 


VERTICAL 


HS {rear 


are covered in the tolloming sources: 


Poole, McNifft 


& Cook Your Atari 


Coaputer Osborne/McGram Hill op. 


40 PRIMI: PRIMI: PRIMI“Potential tatal e 
rror’: PRIMI" Iry again": FOR K-1 10 206; 
MEKT B:6.2078 


1030 PRIMT“iisted below. Be sure te 
eep the “: PRIMI" proper spaciag.~: Pee 
731,68 

1040 POS.2,7:PRIGT OOTRSCOCLomin- 1), 


SO PRIMT CHRS(125): PRINT: PRIOT:PRIMi“t a 

{ 307-324 ae uae, pan eka *1ORUK 1905)"; DOTASCLOCLOMCR 1D, 168 
suey ~ you pas mt one o to POWE 53256,1. POKE in a3to find | Hy ie a: lesen va (G12); PRIMT CORSEZ7); :PRIMT Coase 
several doghouses created on the screen the equations for quadruple width. The | “Ai : 
using a redefined character set in one Saall, Small & Blank THE CREATIVE ATARI eee 1050 Paint --": 905.2, 7:08 

graph shows that the horizontal | trast Coaput p 1983 72 PRINT: PRIBI“entry @ tilenane / 
of the text sodes. If the houses are relationships change, but that the | hes? aime ele Nong: cag sare“: PRIMI 2 acapseaelipcoaed atten Peebe git 
identical except for their location, vertical equation 1s the same for all $0 | ie 7S att. oe Fe ee ee we 
vou need to know how to map the | , 90 K-O:1RAP O27: INPUT EK: TRAP cence 

widths. 2060 1S(91S(10) DOIRS COtLomiK-4), 268 

bases ee i ‘ Fox & Waite COMPUTER ANIMATION PRIMER 92 MET. ; 
locations of the houses on the dog ' l ; i keg Bikakaies unite sig rs 6d dala A re sake, Tre eT: 
coordinate systea in order for the In rier te hbiee the \ Y Re seretn 2070 PORE 1543, 00:M-m5R (1536, aOR (DO! 
Computer to know when the doa entered bakat Veenhi : : Re 13:6.50 
ps for single-line 100 BIM OOIAS (1070), 15012) :001R5=" “; 

the correct house. A simple collision | Stanton & Pinal ATARI GRAPHICS AND oorasiie7e)-" ~: 9018592) -werRs eee 

resolution players, the following See REM) bate 
detection will not give you the answer | ARCHADE GAME DESIGN Arrays, Inc. 1984 10S OPEM M3,4,0,°C:":POKE 752, 1:005.2, 

; Changes to the program are necessary: ry earement  Econier HL -20 pipetar= $007 REM 

if the houses are identical. ° pp. | waeanene PIG. cs 


As another exaaple,suppose | 
Created a blinking cursor from a plaver 
and | want to place it at Mode 0 


236 POKE 559,62 

270 change 512 to 1024 and change 
640 to 1280 

310 change 120 to 240 


20 
PLAYFiELD CoorniaTes (move P) 


LISTING 


Seyer ATARI PLAYER-MISSILE GRAPHICS IW 
BASIC Reston “ublishino 1984 158 po.s 


110 FOR 1-1536 TO 1556459:RE00 OYIt: Pe 


L,OVIE:MEXT [QE SET UP m@ ROW INE 


170 PRIGT:PRIMT:PRIMI"Insert di:sh 18 8 
Fave I": PRIMI"and press (RE Tuam)”; :605 


$e76 D.104,169,1,161,1,3,169, 62,148, 
3,104, 141,3,5,104,161,6,5,169, 105,44 
16,3, 109 

3e0se O.1,161,11,5,169,6, 148, 255,6, 32 


yf ibee 3,226,24,173,4,5,105,126,161,4,3, 046 
320 change 512 to 1024 and change 100 PRINT CHRS(125):REM CLEAR SCREEN 1008 een $015 ©.736,5 

Coordinates (20,20). Where do 1 POKE 640 to 1280 105 PORE 752.1:REM INHIBIT CURSOK 1001 REM) DISPLAY ROUTINE < $040 9.3,256, 10.5, 206, 258,6, 200,251, 

the plaver in its own coordinate 110 POSITION 0.11 1002 REN 


systea? 


The prograa listing shows how to 


It you run this aodjtied prograe 
you will find that the relationship 


120 PRINT 
“012545678901 23456789012345678901234567 


1010 M-USR(1S36, AOR (OOIRS)) REM READ DB 
[5a DIMECTORY 


1620 5-8 
between the horizontal coordinates are a9* 108. bes imate 
line up the two coordinate systeas. It the sase as for double-line resolution. 130 FOR J=0 10 23 sess Gas. de 
assuses that you know the basics of 


Player /Missile graphics. If not, there 
are nuserous articles in Atari books 
and eagazines that explain how to setup 
and use Player/Missile graohics. 


However, there is a change for the 
vertical equations. 


Using these equations vou can 
easily transter back and forth between 


bieatol 


140 POSITIIN 21,J 

150 PRINT J-INT(J/10)010;:NEXT J 

160 POSITION 2,2;PRINT “X POSITION" 

170 POSITION 25, 2:PRINT “Y POSITION® 
200 J=PEER(106)-16:REM SETUP POINTER 


1060 V MSC CODIRS (i ttems, 116859) 
1070 If V-06 O8 UV 56 Intm PRtet yon;” 


“, OOTAS (otiems, 1341685) 5". pOTes( 


14t1ems, Letiemysy 5 "; 


Hoc 


ee RR 


pow $4 


PAL-ACE 


THE MUSICAL ATARI 
(a piano keyboard) 


by Harald S. Poelchau 


The Atari can make noises of all kinds, and eusical ones 
too. You can convert the Atari keyboard to a ausical 
keyboard, ia@itating a@ piano (sort of). The following 
prograe shows a sSiaple way to use the keyboard to play 
tunes. 


The approach here is to use look-up tables to convert the 
keyboard character codes to the pitch codes used in the 
SOUND command. We first read the pitch nuabers troa C 
below eaiddle C for 3 octaves and store thea in array S. 
Wext, one could fill a corresponding array with the 
Character codes, and then test for the one that equals the 
key pressed. This procedure, however, takes too auch tise 
for the higher notes, and slows down the response. A 
better way 1s ta use the key character code as the index 
for the position in array K which holds the index for the 
Corresponding pitch code in array $. This assures equal 
access tiae fcr all keys and is auch faster. 


The beyboard is arranged such that the lowest row of keys 
represents the lower white keys of the piano. Ihe third 
rom continues with the higher notes. The keys in the row 
just above the lowest row contain the sharps and flats, or 
black notes on the piano. The sase goes for the top row 
of keys. So, the 1, X, C keys would sound the low C, D, 
and £ of the piano, and so on upward. 5 and D woud be CO 
and D#. The keys with ’.” and ’/’ are aiddle C and 0, and 
the scale continues mith the @ key. If you are serious 
about using this keyboard it aight be useful to fashion a 
beyboard overlay tc show the right notes. 


Line 199 opens the keyboard for input. The sain loop of 
the progras iroa jine 200 to 260 gets the key input and 
stops the sound of the previous note (200). 210 prevents 
an error 9, and 220 1s all that 1s necessary to get the 
proper index of array S tor the SOUND statement in line 
244, At the same time we check for unassigned keys. for 
sose added entertainsent | aa changing the screen color 
for each note, in line 230. That’s all there is to it. 
Now try sour Star Wars theae. 


100 REM +¢¢ MUSICAL ATAK] KEYBOARD +++ 

110 KEM... by Harald S. Poelchau ... 
August 1964 

120 DIM (94), 91378 

tg FOR G22 10 2P2READ ASSCT)=KS NENT | 

Su GR Y=) TO 9Ore (1-0: NELT I 

low FOR i=! 10 37: READ ASRUMD=ESWERT | 

1?u GRAFHICS 16 

180 FOSITION 2.5:° #6: °MUSICAL EYBOARD® 

19u GFEN @1,4,0,°b:° 

2) GET 01.0: SOUND 0,0,0,0 

219 TF 496 THEN 206 

22u Jen (Arc 1F 150 THEN 200 

210 SETCOLOK 4,1,8 

240 SOUND 0,511), 10,10 


PAGE 14 


260 6010 200 

270 DATA 243, 230, 217, 204, 193, 182,173, 162,153, 144, 136, 128 
280 DATA 121,114, 108, 102,96, 91,85, 81, 76, 72,68, 64 

290 DATA 0,57,53,50,47, 45,42, 40,37, 35, 38, 31, 29 

300 DATA 90,83,88,68, 67,86, 71,66, 72, 78, 74,77 

310 DATA 44, 76, 46,59, 47,81, 50,87, 51, 69,52, 82 

320 DATA 84, 54,89, 55,85, 73,57, 79, 48,80, 00, 45, 6! 


MX-B8O GRAFTRAX+ ATARI CODES 


PRINTER FUNCTION DEC CODE LP. CODE 
BACKSPACE CHRS (8) CIRL-H 
DOUBLE WIDTH (to end of line) "14 CTRL-N 
COMPRESSED NODE Ae CIRL-O 
Cancel COMPRESSED KODE * 18 CTRL -K 
Cancel DOUBLE WIDTH MODE "20 CIRL-T 
Escape code and character ua ESC-tSC 
UNDERLINE MODE (N=O=0FF; N>O0=0N) “<ESC)45N <ESC/-N 
Set line spacing to 1/8" E5048 ESC 20 
Set line spacing to 7/72" (ESC 949 “ESC 31 
Return spacing to default 1/6 <£SC>Su -E9C;2 
Set spacing to N/216 (1<=N¢=255) CESC.SIN sESCIN 
Italic character set ON €$C)52 (ESC>4 
Italic character set OFF .£SC,53 (ESC5 
Reset special aodes to default ESC 064 (ESC>8 
Set LF spacing to N/72°(CESC “ANI <ESC 65 sESC0A 
Set fora len to N lines (dei.= 06).69C067 cESCOL 
Turn on EMPHASIZED MODE vESC 69 sESCE 
Turn off EMPHASIZED MODE sESC>7u (ESC OF 
Turn on DOUBLE STRIKE MODE CESC071 <ESC>6 
Turn off DOUBLE STRIKE MODE £50972 sESCOH 
Sets skip over perf to N lines ‘ESC)78 sESCON 
Resets skip over perf to 0 lines .£SC)79 (ESC 0 
Sets SUPERSCRIPT/SUBSCRIPT MODE <ESC>B3 <ESC)S 
Format <ESC)*S*N, N=O=superscript, N0=subscript 
Reset superscer.,subscr.,unidir.  <ESCB4 (ESC)T 
Unidirectional printing (L to R) <«E€SC>B5 \ESCU 
DOUBLE WIDIH on till turned off <ESC/8? (ESC OW 


The above chart of EPSON printer codes was provided by 
Bob Dain. Jt is euch amore usable than the chart 
provided in the eanual. 


DAL —ACE 
COMPUTER FAIR 
ADMISSION: 1 TOW 
(HEM TOY OF 63.00 VALUE OR =CASE) 


CAZETT = 


MicroFiler File Converter 
by Ronald Orr 


progras. It’s widely advertised, including the Susser 
filing systee prograe I’ve seen that sakes use of 


one drawback: 1t uses a non-DOS tile format for disks. 


to DOS files which can be used by Basic, Atariwriter 


lines 560 to 630. 


cleaned up the structure considerably. The ability 
recognize the fields mithin a data record mas included. 
to the use of Basic IL as opposed to plain Atari Basic, 
believe that if you are at all serious about prograseing 


structure, functions and speed) are clearly superior to, 
upwardly coepatible with, Atari Basic. 


MF 2D0S 


10 Ree MICROFILER 10 DOS CONVERSION 

20 Rea WRITTEN IN OSS BASIC IL 

30 Rea PRECOMPILE : WO PARAM COUNT OW USR CALLS 
40 Fast :Set 8,0 

50 Ree GET 128 BYTE OPEN BUFFER 

60 Die Bulfer$i128) ,Char$(1) 

70 Dia Friles(ib), 18110) 

80 Bulfer$=° *: Bulfer$(128)=Bulter$: Buffer $(2)=bulfers 
90 Buffer adr=Adr (Buffer $) 

100 Sector=5 

110 Total=0: Index=128 

120 Print *MicroFiler to DOS conversion’ 

130 Print ‘DOS disk in Drive 1° 


140 Print ‘Microfiler disk in Drive 2° 
150 Input “File Naee*, 18 

160 Files="Di;* 
170 Files=Files 18 


The Microfiler database prograe cartridge  troa 
Microbits Peripheral Products 1s an iapressive file systea 


issue of the Atari Connection aagazine. It's the only 
cassette recorder, a practical proposition. However, it has 

The following program converts data disks froe 
Microfiler (which uses one physical disk for each data file) 
whatever. This particular progras prints each field of each 


record on a separate line and skips a line between each 
record. If this does not suit, then “auck around’ mith 


The original prograe was written by Microbits 
Peripheral Products. | converted it to OSS Basic HL which 


Basic you will use Basic IL as its ieprovesents (richer 


Nov/Dec 1984 | 


180 Rea READ TO EWD OF SCREEN DATA 

190 While Total<880:Gosub 710 

200 = t=Asc (Char $) 

210 If 1=0 Or 1=128;bosub 710 

220 Total=Total tAsc (Char $) 

230 Else :Total=Total+! 

240 Endit 

250 Endwhile 

260 Rea DETERMINE RECORD LENGTH AND STEP PAST TABLE 10 
RECORD DATA 

270 bosub 710: Nt) ds=Asc (Char) 

280 Print “Muaber of fields is “;Nflds 
290 Dia FidleniNtids) 

300 = For +1 To Wilds 

310 For J=1 To 4 

320 Gosub 710 

330 Next J 

340) Fidden(1)=Asc (Char) 

350 Print “Field °31;" length 1s °;FidlentI) 
360 «Next I 

370 bosub 660:Reclen=1 

380 Print “Length of record is *;Reclen 
390 bosub 660: Reccnt=1 

400 Print °M of records 1s *;Reccat 
410 Dia StgstReclen) 

420 For 1=1 To 3:6osub 710;Next | 
430 For I=1 To Nflds 

440 6osud 710:6osub 710 

450 Next | 

460 Rea GET THE RECORDS 

470 Open 01,8,0,Files 

480 for 1=1 To Reccat 

490 For J=1 To Nflds 

500 Stgs="° 


510 For K=1 To Fidlen(J) 

320 bosub 710 

530 Stg$=Stgs, Chars 

540 Wext K 

550 Rea STRIP TRAILING BLANKS 

560 lf Right $(Stgs, 1)=" Then 


Stg$=LeftsiStg$,LeniStgs)-1):boto 360 
570 Print Stg$ 
580 Print @1;Stg$ 


590 Wext J 
600 = Print 
610 «Print @1 
620 Next | 
630 Close @1 
640 End 


650 Rea $8 SUBROUTINE T0 GET BCD 
660 bosub 710:18=Chars 

670 Gosud 710: 18-16, Chars 

680 1=Val (Hexr$(Dpeek (Ade (18)))) 
690 Return 


roantinned an nana O raliuan 7 


Mezsamical Notes 


By Jay Gerber 


Hello, fellow ausic enthusiasts, and welcoae back to 
Musical Notes' This month we are going to finish up a 
fem aore points which mil help you to transfer sheet 
music directly to your coaputer. We will also discuss 
how to make a limited Basic prograe that plays sheet 
@usic. And as always, We shall have a great tiee! 


Last aonth | was explaining the concept of chords in 
ausic. As | stated last aonth, you can think of a chord 
as a series of notes, one atop another, that are played 
at the same time. These notes aust have the sase dura- 
tion. Instead of going into soee sore theory about 
Chords, it 1s safe to say that you will see alot of 
chords in all types of sheet ausic, so you should learn 
to recognize and use thee. 


One interesting aspect about chords (especially to 
the Atari owner with only 4 voices) is that the top note 
of the chord always (unless seperated froe the selody 
line) contains the selody of the piece. For exaaple, 
loot at figure 1. This is a piece of sheet ausic that 


you aight find in any ausic store. Notice that all of 
the notes are arranged in chords. If you were to play 
this on a piano, or sisilar instrument, you would hear 
the Cantina theae froe the aovie Starwars. If you were 
to play only the top note of each chord, you mould still 
hear the Cantina theae. The lower two notes of each 
chord are just accoapianaent, or haraony notes. 


This is useful for typing sheet ausic that has aore 
than four voices into the computer. If you just wanted 
ta put dow the selody line, and arrange or forget the 
chords, look for the single notes in (usually) the 
Treble staff, and take the tops off of all chords in 
that staff. 


Well, 1 think you all should applaud yourselves’ You 
should, finally, be able to read any piece of sheet 
eusic! Now, how to aake the Atari coaputer play it. 


There are several ways in which you can make the 
Atari play sheet ausic. One is to buy one of the 
several commercially available music pacakages on the 
@arket, such as AMS 11, and Music Construction Set. 
(These and others will be reviewed, along with tips and 
Saaple sessions, in later coluans). Another way 1s to 
program a@usic player. In 6502 Assembly, or sachine 
language, this can get very hectic, or tedious at best. 
You can try Logo, except it only plays in two voices, 
and 1s hard to work with ausically. 1 never figured out 
Forth, Pascal, or those scientific languages, so the 
only logical choice would be the one that most of us are 
fasiliar with: Basic. 


Before | discuss the Basic ausic progras, let ae say 
that although the easiest to use, Basic 15 also verrry 
Slow' It is impossible, without the help of aachine 
language routines, to have all four voices playing 
different rhythas at the pase time in Basic. In fact, 
getting two voices to play different rhythes is tricky 
enough! for siaplicity’s sake, I have two prograas that 
will let you play either a eelody line, or a selody line 
with chords, provided that all the notes have the sase 
durations. 


Figure 2 1s a one-voice Basic player. Let's figure 
Out how it works by taking it apart line by line. 


1 REA SHER HAH ERER ERR ERE RRR REED 
2 REM * ONE-VOICE BASIC MUSIC PLYR * 
3 REM # BY JAY GERBER ’ 
4 REM # MUSICAL NOTES, OCT. 1984 + 
5 REM RAR eRARA RTARTA RHARR ARR EE REREAD 
10 DIM (20,2) 

19 REM ###READ IN MUSIC DATAS#® 

20 RESTORE 10000 

30 FOR I=1 TO 20:READ 
X,Y:MCL,1)=K2M(1,2)=¥:NEXT | 

40 REM ###PUT BASIC PROGRAM HERE##® 
50 GOSUB 1000 

60 END 

999 REM *#MUSIC PLAYING SUBROUTINE® 
1000 FOR I=1 TO 20 

1010 SOUND 0,M(1,1),10,10 

1020 DUR=200/M(1,2) 

1030 FOR DELAY=1 TO DUR: NEXT DELAY 
1040 SOUND 0,0,0,0 

1050 NEXT I: RETURN 

9999 REM ##*#MUSIC DATA FOLLOWS*##* 
10000 DATA 72,4,53,4,72,4,53,4,72,8 
10001 DATA 53,4,72,6,0,6,76,8,72,4 
10002 DATA 72,8,76,8,72,8,81,8,0,8 
10003 DATA 85,8,81,8,85,8,91,3,108,2 


Pace A 


784 


— 


a Soi tah eerie 


2 es 


S25 a aC 


nate. ee. 


The first 


Line 10 18 a dimension statement. 
disension in the two-dieensional array named M 1s 20, 
This 1s the nuaber of notes that is in the piece. The 
second dieension, 2, 1s the nueber of values for each 
note to be played. This aust resain constant because 
every note has two playing factors: frequency and 
dur ation. 


Line 20 tells the subroutine which reads in the eusic 
data (frequencies and durations of each note) to start 
at line 10000. Line Wreads in two values, mth i 
being the frequency for note 1, and Y being the duration 
for that same note I. Then it stores it into our array 
Called A, so it can be recalled instantly at any tiae. 


Starting at Line 40, you can put in your own Basic 
progras, and aake a subroutine call (G0SUB 1000) anytiac 
you want the ausic played. Line 1000 starts the playing 
routine. For pieces longer than 20 notes, you should 
Change the second varaiable to whatever nuaber of notes 
you are playing. (This is also the first disension in 
the DIM stateeent in line 10). Line 1010 plays the 
frequency of the note that the FOR/WEXT stateaent is 
currently on. Line 1020 figures out a close 
approxi@ation of the ausical duration of the curent 
note. (If the duration nuaber in the DATA stataent is | 
then note = whole; 2 = half, 4 = quarter ...). 


Line 1030 1s what 1s called in Basic a wait loop. 
It mill do absoultely nothing for the nuaber specified 
by DUR, or the approximated ausical duration of the 
current note. Line 1040 turns off the sound. 
Otherwise, notes mith the sase frequency would slur 
together like tied notes. Reaeaber that once you 
execute a SQUND stateaent, the sound is on until you 
execute you turn it off with this stateaent, or hit 
SYSTEM RESET. Line 1050 tells the coaputer to go on to 
the next note, and when it hits the 20th, or last note, 
it will RETURN back to the point after GOSUB was called. 


Line 10000 starts the ausic data. The first nuaber 
in each pair is the frequency value; the second, the 
duaration. Obviously the order of the pairs has to 
correspond directly to the piece of music. The 
statesents are arranged in no particular fashion, except 
that all DATA staeaents fit on one 38-coluan line. 


Figure } plays the saae song with three note chords 
instead of single notes. I[t works the exact sase way 
that figure 2 does, except it has to handle three 
frequencies to each duration. Qne thing you aight 
notice is that it is slighly slower than figure 1. This 


1s because that it takes tise to execute each SQUM 
statesent seperately. 


1 REM SHORE ERE EHEE ERR EE EERE e 
2 REM *#THREE-VOICE BASIC MUSIC PLYR® 
3 REM # BY JAY GERBER * 
4 REM #® MUSICAL NOTES, OCT. 1984 
5 REM #Raheeeeeeeeeetaeeeeeaeeeaaees 
10 DIM M(20,4) 

19 REM ###READ IN MUSIC DATA##® 

20 RESTORE 10000 

30 FOR I=! TO 20:READ 
VIi,V2,V3,DeM(1, 1) =VIsMC1,2)=V22N01,35)=4 
S:M(1,4)=D: NEXT I 

40 REM ###PUT BASIC PROGRAM HERE&®ae 
50 6GOSUB 1000 

60 END 

999 REM #MUSIC PLAYING SUBROUTINE® 
1000 FOR [=1 TO 20 

1005 FOR J=1 10 3 

1010 SOUND J,M(1,J),10,5 

1015 NEXT J 

1020 DUR=200/M(1,4) 

1030 FOR DELAY=1 TO DUR: NEXT DELAY 
1035 FOR K=1 TO 3 

1040 SOUND K,0,”,0 

1045 NEXT K 

1050 NEXT [: RETURN 

9999 KEM *#aMUSIL DATA FOLLOWS#e## 
10000 DATA 72,91,1086,4,53,72,91,4 
100C1 DATA 72,71,198,4,53,72,91,4 
1v002 DATA 72,91,108,8,53,72,91,4 
10003 DATA 72,91,198,8,0,0,0,8 

10004 DATA 76,96,108,8,72,91,108,4 
10005 DATA 72,91,108,8,76,96,114,8 
10006 DATA 72,91,108,8,81,96,121,8 
10007 DATA 0,0,0,8,85,102,128,8 
10008 DATA 61,96,121,6,865,114,136,8 
10009 DATA 91,121,144,3,108,144,182, 
291,108,8,81,96,121,8 

10007 DATA 0,0,9,6,85,102,128,8 
10008 DATA 81,96,121,8,85,11 


These two prograss mil help you add eusic sate 
alaost any Basic prograe. They were kept simple so yo 
could easily modify and incorporate thea rato you 
prograas. One last thing about the second prograa 
though: itis uneven at ties. This is due, again t 
the tise it takes Basic to opecate all three voices a 
the sase tise. This can be corrected by changing th 
durations of aoditying the approximation routine. 


Well, that’s just about it for this aonth. Ina the 
coming months | mill review, mith actual examples o 


Page 9 


Current Notes 


eS Se ee en an eee eaisess sae e eeaee 


usage, the three a@ajor ausic packages for the Atari: 
Atari's Music Composer; API s ANS | and LotsaBytes’ ANS 
also, after thauroughiy explaining the ausic packages, 
get into some hard-core ausic theory, and show how you 
can ieprove your ausic to emake it sound better, 
especially froa sheet eausic. 


Ta all you aspiring eusicians: keep those ausic files 
Coaing. Jo those of you who have not sent or given to 
ae (at meetings) your favorite ausic files -- why not? 
Send thea to: Jay Gerber, 3639 N. Sth Road, Arlington, 
Va. 22207, You can also drop thea off at either the 
Novatar: or OC aeetings. 


Oh, betore | forget 
last aonth’s chord-finding quiz: 


Here are the answers to 


6 (6/0/81; & (B/D/6); C <C/E/E; & (G/D/B); & 
(D/B/G); C (C/G/E); G (6/0/B); 6G (D/B/G); F (C/AF); D 
(A/F A/D) 


It was pretty tricky since | put all of the chords in 
the Bass clef, and figure 3 (last eonth) was in the 
Treble'' Well, this eanth you can practice entering 
sheet ausic into the Basic prograas, and as alway, HAVE 
FUN! 
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AbAcvs eT BY 
Creating a Different 
Disk Directory 


(The following is reprinted fros ACCT 
(Agril, 1904), the newsletter of the 
newsletter of the ATARI Computer Club 
of Toledo. Author unkaom. ) 


Thanks to Fred Choske for an 
anauer to lest sonth’s question, “How 
can you create a disk directory for 
your programs other than in the 
standard location of sectors 361-368?" 
He referred us to a book fron MAR 
SYSTEMS by George Morrison called 

jon J 
Basically, the aethod is a8 follow: 


1. Back wp your completed disk. 

2. Copy the directory to a new 
location. 

3. Alter DOS to point to your new 
directory. 005 is stored in 
eamory. Location 4226 norwal ly 
contains 105, which tells 006 to 
look to sector 361 for the 
Directory. Compute the new value 
= 106 + (new directory sector 
muaber - 361). Then OME 4226, 
raw value. 

4. Write the altered DOS files to your 
disk. 

5. Destroy or change the old 
Directory, VTOC and DUP. SYS file. 


The book, although small, contains 
a mmber of ways in which softwere 16 
protected, and some small prograss to 
enable yes to accomplish this 
protection. 


Jay Gerber pot 6 
Before we goon toa review of ali the ATARI ausic 


packages, let Ss digress to a discussion of ausic and its 
history. 


Music 1s the art) of controlling and organizing sounds 
inta intelligible patterns. The origin of ausic 15 un- 
krown, and it 15 aS aysterious as the origin of aatheaa- 
tics, art, or other abstract subjects. One aight suppose 
that the first intelligible pattern of sounds aay have 
been ade by primitive aan, banging wooden clubs to a 
rhythaic beat. Perhaps im accospianiaent of this banging, 
the caveaan started grunting on selected beats. Then 
another one started scraping the wall of the cave, and so 
this prigitive fora of noise mould eventually becoae ausic 
as we know it today. 


The first theories about ausic were developed by the 
ancient Greeks. They developed the present day ausical 
scale of the related frequencies which | presented 
earlier. Pythagoras, the Greek sathematician whose 
triangle theorem is widely used, 15 believed to be the 
first person to devise a instrument to play the tones of 
the set ausical scale. 


Pythagoras found that the frequency of a note depends 
on the nuaber of vibrations an abject makes. By taking a 
aetal wire and stretching it between two nails eabedded in 
wood, he created what 15 known as a sonochord. By pluck- 
ing the wire, a tone is produced. Pythagoras learned that 
if he shortened the vibrating length of mire by pressing 
the wire down on the aonochord, a higher pitch was creat- 
ed. By moving his finger up and down on the wire he 
shortened or elongated the wire, thus producing higher or 
lower tones. 


Pythaguras soon discovered that certain tones are re- 
lated to one another, and that when these notes were play- 
ed ina Certain progression, different moods could be 
created. For instance, a certain set af notes played in 
sequence could create a funeral dirge, another a happy, 
celebratory song. 


The Greeks developed music into an art fore, and devis- 
ed any theories that are still used today. (We will be 
getting into the basics of these theories in later 
coluans.) The Rosans, being aore interested in killing 
each other, did little with eusic. The next developaent 
of ausic took place in the aiddie ages with the coaing af 
the Crusades. Church ausic developed from a4 series of 
chants to hyans, played mith, inthe later part of the 
period, an organ, 


It 15 during this period when ausic was first recorded 
on paper. Before, aelodies and hareonies were esesorized 
and handed down froe generation to generation through the 
years. The aseaorization process was not an easy one. 
Choir eeabers had to remember doth the words and notes 
associated with thea to all the psales in the Bible. In 
order to make the tash easier, Guido d‘Arezzo, an Jith 
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century Italian Choireaster, deveoped a systea to write 
and read the ausical notes in order to save tise. He 
developed what would eventually become the eusical staff. 


He sung the lowest and highest notes that were used by 
his choir. Then he wote out a set of seven lines placed 
parallel to one another. He dipped the square end of his 
pen into ink, and marked the bottoa line with a square. 
Then he sung the lowest note again. We then sung the next 
higest note he knew of. He placed this aark in the space 
between the 7th and oth lines. He kept adding notes until 
he got to the garb on the top line, which was the highest 
note that was sung in the Psalas. 


It was not until! the late 17th century that the staff 
developed into the one used today. It was at this tiee 
that haraonic theory was developed. It was also the tie 
ot the great classical coaposers. All of the a@usic we 
hear today, including rock, Country, earch, western, or 
whatever, contains techniques developed by Mozart, Bach, 
Beethoven, and the other composers in the late 17th and 
early !6th centuries. 


Well | hoped you liked this dissertaion, Mext aonth, | 


will discuss the ATARI] ausic fackages just in tise for 
Christaas. Hope to see you Bach next aontn''' 
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R-Verter Modem Adapter Review 
by Jeff Hogue 


This text has been transeitted to you by ay Atari 
Connected to a Hayes 300 baud eodea by a R-Verter sodee 
adaptor froa Advanced Interface Devices (AID). This device, 
which lists for $50, looks like an fasiliar Atar: serial bus 
Connector attached to a wire going to a sale 0825 (RS-232) 
Connector. There are a few aicrocircuits in the 0825 but 
they get their power fro the Atari. 


There have been a number of general purpose devices 
which substitute for the printer function of the Atari 610 
unit but this is the first one | know of which replaces the 
serial function. There are a few aodees and printers which 
connect directly to the serial bus, and I’@ using a typical 
disk drive (Trak- see ay related review) mith a printer 
Output port. I wanted to be able to use a stand alone sodee 
with ay Ataris and ay Coapag (IBA PC clone) and to have a 
direct (non-eodea) way to transter files between the two 


without spending a ridiculous aeount for an B50. 


As you can see, it works and it certainly reduces the 
ess of wires associated with an Atari. On the other hand, 
it’s taken ee a little while to get here..... 


The device works by replacing the Atari serial handler 
loaded during a correct power-up sequence from an B10 with 
an AlD-provided handler loaded, say, as an AUTORUN.SYS file 
at boot-on. You need a MEA.SAV file also which really slows 
down getting in and out of DOS. 


Actually, the worse problea | ran into was mith the 
version of Asodes which | was using. It had soee sort of 
weird tiaing problea and just didn’t work. The AID people 


eventually equipped ae with a special version which works 
correctly. 


I don’t know of any local place to buy the device, but 
I’ve seen it advertised in the Atari-oriented sagazines. AID 
needs to know what class of sodeas you intend to use it with 
Since the RS232 “Standard” seees to coee in a lot of 
flavors. 


AID has been good to perhaps overwheleing with 
technical help and they are even putting in a Bulletin Board 
for purchasers, if you can afford a call to Florida. 


1 think it 1s @ good way to a@inieize the cost and 
physical size of an Atari syste while keeping a good deal 
of flexibility. It hasn’t been the aost strarght-formard 
Coaputer problea I've worked with but | sees to have a 
solution in hand and I'll be glad to help you through the 
5.B.A.C.E. users group if you decide to give it a try. 


BARGAIN CORNER 
BY DANIEL PRINCE 


Here are soae bargains | have found this tiee: 

beorge Beekaan has a few of his very high quality 48k 
boards left for $75. Coaputer Mail Order,P.0. Box 66449, 
Stateline, NV 89449, 800-648-3311 has the Indus 67 disk 
drive for $279 +32 shipping. 


The following inforeation is courtesy of Aaron Todd: 


Many ATARI parts, including complete boards and service 
data are available from at least two sources in Calif. | 
have ordered froa Aaerican IV Sales, 15338 Inverness St., 
San Leandro, CA 94579 415-352-3787. 1 found thee pleasant 
and quick on service. Tell owner Ralph Maddox that you read 
this in the SBACE news letter. 


Another possibility 1s Centurian Enterprises Box 3233 
San Luis Obispo, CA 93403 805-544-6616. I have not ordered 
from thea, but when | called for a Catalog, it arrived in 
two days. SSAARONSS 
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700 Rea $% SUBROUTINE T0 GET CHARACTER 
110 Index=Indextl 

720, Lt Index=129: Index®1 

730 = Poke $0301, 2:Poke #0302, 52 

740 =Dpoke $0304, Buffer adr 

150 Dpoke $030A, Sector 

760 Dumay=Usr ($£453) 


170 = Sector =Sectortl 

780 = Endift 

190 Char $=Bulfer$(Index, Index) 
B00 Return 


| work with coeputer systees at work but don’t get 
hands-on experience there. | ‘mess around’ mith ay tuo 
Ataris (800 & 1200KL) at howe. | wrote the conversion 
prograe to feed the Microfiler data into Atariwriter to be 
able to paginate the printout {roe AicroFiler. 


Ronald Orr 

168 Hill Street 
Hereosa Beach CA 90254 
(213) 379-2515 
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an * TH SOUND 
by Lee Minard 
You've already heard me 


complain about the lack of realisa 
in the sounds you get fom the 
instructional books...and the ATARI 
can do wonders with sound...so 
here's another of ay attempts to 
get more out of my BOO@XL! 

This time, i'm working on the 
sound of a train. Why you ask? 
Well, I did it for the challenge. 
And I learned a lot from it. Hope 
you do too. 

This is an attempt to build the 
sound of a steam locomotive 
pulling out from a station. I got 
close. 1 was never satisfied with 
the whistle sound...I'd love to hear 
how you improved it. 


oe ae oe eee ee 


1@ REM TRAIN SOUND 

2@ REM BY LEE MINARD 

3@ REM STARFLEET, DENVER 

4@ GRAPHICS 2 

45 POKE 752,! 

50 B=103:H=1 

6@ REM STEAM RELEASE ##*# 

7@ SOUND @,1,8,4 

@@ FOR DLAY=1 TO S@sNEXT DLAY 
9@ FOR STEAM=12 TO 6 STEP -@.5 
188 SOUND @,1,8,5TEAM 

11@ FOR DLAY=1 TO S@:NEXT DLAY 
126 NEXT STEAM 

138 REM CHUGS #44 

140 FOR G=15 TO 1 STEP -@.25 
15@ FOR A=G TO 2 STEP -@.5 
14@ SOUND @,B,8,A 

178 SOUND 2,B+1,6,A 

180 NEXT A 

182 REM SPEED UP CHUGS ### 


19@ FOR DLAY=B#2 TO 15@:NEXT DLAY 


195 FOR DLAY=1 TO 25:NEXT DLAY 
200 B=B+2 

205 REM GRAPHICS FOR “TRAIN” ### 
210 H=H+1 

220 IF H=4 THEN H=1 

23@ IF H=2 THEN GOSUB 448 
24@ IF H=3 THEN GOSUB 448 
25@ IF H=1 THEN GOSUB 488 

270 IF B=98 THEN 2978 

28@ NEXT G 

265 REM WHISTLE ### 

29@ FOR X=1 TO 108 


300 IF x=12 OR X=14 OR XxX=65 OR | 
X=69 THEN SOUND 1,75,10,5:SOUND 
3,50,10,45SOUND 2,52,49,4 

310 IF Xe13 OR X=16 OR X<68 OR X=78 
THEN SOUND 1,75,1@,1:SOUND 
3,5@,10,1SOUND 2,52,14,1 

330 IF X=19 OR X=78 THEN SOUND 
1,8,0,@:SOUND 3,,@,@:SOUND 2,@,8,@ 
340 FOR A=9 TO 1 STEP -@.4 

35@ SOUND 0,86,8,A 

368 NEXT A 


380 FOR A=9 TO 1 STEP -@.4 
382 SOUND 0,84,6,A 
A 
aes BEN FOR DLAY=1 TO 2:NEXT DLAY 
386 7 “CHOOO “: 
39@ GOTO 380 
440 7 €6;"TRAIN’: 
45@ RETURN 
460 ? #6; “EEIOEE 
470 RETURN 
480 ? 06; °*(3RENND'; 


498 RETURN 
one 


Syrzre»r 


Syzygy is the name Nolan Bushnell found 
Atari under in the early 1970s. It was ¢t 
first company he formed and it produced ¢t 


now famous Pong game, the grandfather 
arcade games. 
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SynCalc: 
Serious Computing tor 
Atari Computers 


By Steve James 


By now, you have probably seen the new 
advertisements tor Synapse's new applications 
programs for the Atari. A review of the powerful new 
database program, SynFilet will appear ina future 
issue of Keeping PACE while this article will review 
SynCalc, an advanced spreadsheet program. The third 
applications program: SynTrend will be reviewed as 
800N 46 One Of Our members obtains a copy. 


Syncalc is, without a doubt, the most advanced 
Spreadsheet to become available for Atari computers. 
Like any spreadsheet, SynCalc lets you work with rows 


and columns of numbers. This makes spreadsheets 


useful for budgets, stock portfolios, scientific data, 
financial reports, loan schedules, and other 
applications that require handling a lot of numbers. 
Spreadsheets function as electronic calculators with 
large memories, $0 people have begun to use them for 
“What If?* analyses of a particular problem. For 
example, you could set up a spreadsheet to look pst 
Like a Form 1648 that you get from the IRS. However, 
the spreadsheet also allows you to program it by 
inserting the same formulas that you would use to 
figure your taxes, such as “subtract line 28 from line 
19." This means you only need to enter the raw 
numbers intq your form and the spreadsheet 
calculates all of the results instantaneously. This 
makes it easy to try several cases and record the 
results. People often call this exercise a “what 1¢" 
type of analysis. 


Historically, Atari owners have had a limited 
choice in spreadsheet programs. About the only 
programs on the market were the original Visicalc, at 
$150* and HomeCalc, a very limited version of 
Visicalc for about $4@. Most other computers, 
including home computers have a much wider selection 
Of spreadsheets, some far more powerful and flexible 
than Visicalc. This always puzzled me since there is a 
well Known saying that Visicalc sold more Apples than 
Apple sold Visicalc programs. Anyway, my longings 
for a truly powerful spreadsheet were satisfied when 
Atari began marketing Synapses new SynCalc 
program. SynCalc lists for $99, which is less than 
Atari Visicalc, yet far outperforms Visicalc. 


SynCalc offers you the choice of menus or 
commands. This is a big improvement over Visicalc 


which only supported command keystrokes, such as /IR 
to mean “insert a new row at the place in the 
spreadsheet marked by the cursor." The menus let you 
learn the commands at your own pace or permit you to 
never worry about memorizing command sequences. 
When you load SynCalc you see the message at the 
bottom of the screen: OPTION = MENU. Pressing the 
option Key brings up a menu window at the bottom of 
the screen with the four main command categories: 
LOAD/SAVE, for loading and Saving data to diskette; 
TEXT, for entering text headings of any Kind into the 
Spreadsheet, NUMERIC, for entering numbers and 
formulas into the spreadsheet; and COMMAND, for 
using any one of a multitude of operations such as 
formatting your spreadsheet, copying parts of the 
worksheet, clearing out errors, printing your results, 
etc. You simply use the cursor Keys to move the 
cursor over one of these menu entries, type return 
and you immediately go into a sub-menu. In each 
sub-menu, you do the same thing, positioning the 
cursor over the item you want and typing return to 
execute the command. This moves very smoothly and 
when direct input is needed from the Keyboard, the 
menus prompt you for it. Error trapping 18 excellent 
and SynCalc rarély lets you do something destructive 
without asking you if you are sure of what you are 
doing. 


Like Visicalc, the computer displays a 40 column 
window into your spreadsheet, which has 255 rows by 
128 columns. Moving the cursor will let you scroll 
smoothly vertically or horizontally though the 
worksheet. You can also go directly to a certain 
location by defining its “coordinates.” SynCalc uses 
the popular format of letters for columns and numbers 
for rows: F25 means the location at the intersection 
of row 25 and column F. Locations In spreadsheets 
are usually called “cells” and the cells can contain 
text, numbers, or formulas. SynCalc lets you format 
either the entire spreadsheet or blocks of cells, or 
individual cells so to display your information exactly 
the way you want it. In the table accompanying this 
review, | have listed the format commands available 
with SynCalc. You can also set the width of each 
column individually; in Atari visicalc all columns had 
the same width. All of the format options can be 
Called through the easy to follow menus. 


Syncalc supports a host of mathematical, 
statistical, and financial functions. A list of its 
functions appears in the accompanying table. Using 
these functions in your formulas unleashes the power 
of an electronic spreadsheet. For example, you can 
enter a column of data and have SynCalc automatically 
Calculate the minimum, maximum, range, average, 
mean, Standard deviation, and variance of the entries. 
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If you then find you Nave made an error, just type ina 
New value where the erroneous value was and 
voila...S;nCalc immediately gives you the results. 


All a: the new Synapse programs were designed to 
snare information with each other. You can pass cata 
to and trom SynFile+ and SynTrend. Visicaic 
worksheets can be converted to tne Syncalc rormat. so 
yOu Can easily upgrade to SynCalc ang save all of your 
Old worksheets. SynCalc passes data to ang from tne 
other Syn-series programs using the Lata Interchange 
Format (DIF), so you can transter data to and from 
other programs that use this format { B/Graph, 
Visicalc, etc J. Furthermore, you can save your 
worksheet to disk as a text file tor merging with a 
word processor, such as Atariwriter. Witn 
Atatiwniter, you can insert a worksheet ir a document 
by first saving the worksheet in text form, then 
loading Atariwriter, typing your document ano 
positioning the cursor where -ou wart tne 
Sor@acsree* tO appear ano typing OPTION-L. You 
nen type CL ano the filename you wish to merge, 
ending «ith the "TXT" e:tenaer, followed by a return. 
While tre snaring of intormation requires tnat you 
load ditrerent programs and save your data between 
them, :t goes let you do tne same things that 
‘integrated Cackages* let ,ou do on computes with 
plenty of memory and big pricetags. 


The synCalc manual 18 excellent. It coes a good 
sob trying to cover all aspects of the program in a way 
that ooth novices ano experienced computer users can 
understand and use. All of the documentation 1s 
typeset on slick paper put into a nine inch high, 
three-ring binder. (It seems that the mine inch binder 
18 becoming the default size tor all computer manuals 
these days.) The manual contains both a Table or 
Contents and a decent Index, which makes it eas: to 
find answers to any question you might have 
regarding the program. It also comes with a handy 
reference card in case you want to be macho and 
dispense with the menus. The program and manual 
break with Atari tradition and acknowleage the author 
and Synapse. My compliments go to Mike Silva for 
doing such a good job on SynCalc. Atari has been 
criticized in the past for trying to Keep their 
programmers anonymous on all but the Atari Program 
Exchange releases. The new applications programs, 
and other new Atari software give credit where credit 
1s due. 


All of the new Synapse programs are heavily 
protected and this can cause some problems with 
different disk drives. Owners of Happy enhanceg 
drives will need to “slow down" their drives before 
they can load SynCalc. Off speed drives can also 


prevent the program trom the loaging. The manual nas 
a section entitled “SynCakc Won't Load” that dezcribes 
Now to check tor faults wher the program wor t loed 
correctly. Tne inaicate speed variations in Orives 
may Orevent o»nCeic trom toading, even when other 
programs ors tine. I nag intermittent trouble with 
an Indus dri.e runring at 22-293 RPM, et had no 
trouble witn ar <1@ drive runing at 2&3 RPM. After 
adusting tne speed of the Indus drive to about 289 
RPM, Syncalc loaded without Droblems. Anyone buying 
the new Synapse programs should check drive speed at 
the tirst sign of any problems loading the programs. 


For those or you who say, “Well, this program is 
mice, but I run out of memory with a 48K machine in a 
hurry” these new programs may be for you SynCalc 
will let you take advantage cre tra memory in your 
computer. It supports eitner tne Alon 128K Ramdisk 
or the Mosaic 64K boards. Other 04K boards work fine 
too, because the Intec 64K board in our 406 gave us 
extra memory tc use. You can even use an 80@ with a 
64K board in each memory slot to get a total of 192K 
and synCalc wall access all of the memory. Marion and 
I are expanding our 80@ with an Axlon Ramaisk to take 
advantage of this excellent feature. 


So, how does SynCalc stack up? In the table at the 
end of this article, | have listea SynCalc's functions 
and features and compared it with Atari Visicalc and 
Lotus 1-2-3 tor the IBM PC. O+ course, since Lotus is 
an integrated package, the comparison isn’t quite 
correct. However, | nave listed the spreadsheet 
features in Lotus to give you an idea how close 
SynCalc comes to standard business packages. At $99 
it 1s a must for anyone wanting to use a spreadsheet 
for more than casual home use. Besides, the authors 
of the new Snapse series have built ways into the 
programs $0 you Can pass data Oetween spreadsheets, 
databases, graphics, and word processing programs. 
It gust isn’t as easy as a single integrated program 
~~ but it 18 much cheaper than buying an integrated 
Package and an IBM PC. Now, 1t I can find tne 
Salesman at the downtown Kautmann’s computer 
department who laughed one day when I said I hag an 
Atari.... 


Spreadsheet Comparison “Continues 
Comparison of Spreadsheet Features ? P 
Format Commands ° 
Feature/Command SynCalc Atari Visicalc Lotus 1-2-3 Individual couln widths y N Y 
Center Labels 1 N Y 
Mathematical Functions Left Justify Labels Y Y Y 
@SUM< ) sum of row or column Y Y Y Right Justify Labels \ Y Y 
aAVG() average Y Y i! Fixed decimal points Y N Y 
@ABS<) absolute value Y Y Y Scintific Notation y N Y 
@ROUND (> rounds number N N Y Engineering Notation ¥ N N 
@INT() truncates to integer Y Y Y Currency Y Y Y 
@RAND ( > Qives random number N N Y Commas Inserted ¥ N Y 
@SQRT() Square root Y Y Y Percent Y N Y 
acos< > Y Y Y — OF ©) If Negative r N Y 
aSING Y Y v DATE (0-M-) 5 N N Y 
aTAN() Y Y ‘! DATE \D-M> N N Y 
@ATAN( > Y Y f DATE (M-Y) N N Y 
@ASING) Y Y v 
@ACcOs<) Y Y Y Worksheet Commands 
@LOG«> base 18 logarithm Y \ Y Protect cell contents ) N Y 
@LN() natural logarithm Y Y v Windows: Horizontal /Vertica| Y ’ Y 
@EXP( ) raise to power of e Y Y Y Synchronized Scrol| Y Y ¥ 
aPi«) Qives value of PI Y Y ¥ Independent Scrol} ; Y Y 
Fixed Titles: Hor 1z/Ver t/Both Y 4 Y 
Statistical Functions Copy: Column or Row Y © ti 
@COUNT() counts items in list Y Y v block of cells (rowkcolumn) N N Y 
asTD( > Standard deviation Y N i Move: Column or Row Y Y Y 
aVAR() sample variance F " ¥ Block of cells (row&kcolumn) N Y 
@MING) Y Y ‘ Recalculate: Automatic/Manua!l ( Y Y 
aMAX (> Y Y Y By rows or columns i Y Y 
@MEAN< > Y N N Global Formatting 1 Y Y 
@RANGE() =range in row or column yY N N Insert/Delete Y y y 
Print: to Printer ’ Y Y 
Misc. Functions to File (text) ‘ N Y 
@ERR error display N Y y range of cells Y Y Y 
aNA not available display N Y Y cell formulas rf i Y 
@I1SNA data unavail. display N N Y Printer Codes in celle Y N N 
@DATE< > Qives serial date N N Y Printer Codes in set-up N Y Y 
@TODAY «> date from log-in hy N Y Macro commands N N Y 
OIF) THEN( )ELSEC) Y N Y DIF format save Y Y Y 
@CHOOSE(> choose an option N N Y Convert from DIF format 4 Y Y 
@LOOKUP > lookup in table Y Y Y Convert from Visicale format Y N/A Y 
Convert to Visicale format N N/A Y 
Financial Commands Use Labels in formulas i N N 
aFV<¢) future value Y N v Sort (rows or columns) Y N Y 
@NPV«) net present value Y Y v Initialize a diskette Y Y Y 
aPv() present value of loan N N y Delete files on a diskette Y Y Y 
@PMT «> loan payment Y N Y Goto a specific cel) Y ¥ Y 
@IRRC) internal rate of return N N Y Allow label » column width Y N Y 
Memor y Required 48K 48K 192K 
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SynrFil e+ 
BY SYNAPSE, DISK, $69.95 


Rviewed by Joe Haters 


SYWAPSE describes Syafile# as “the aost 
powerful and advanced database eanagesent systea ever 
created for ATARI Hose Coaputers.” This clai@ @ay, 
indeed, be true. But, before you run out and plop down 
your eoney, let ee caution you that the first part of the 
phrase “aost powerful and advanced database sanageaent 
systee ever created” is qualified by the second part “for 
ATARI Howe Computers." Syafile* does not coapete mith 
sainfrase database aanageaent packages or with the aore 
powerful 16-bit eicrocomputer packages like dBASE III. It 
is, however, functionally very coapetitive with any other 
product available for the ATARI, and, indeed, can compete 
favorably with a@any of the “filing sanager” prograss 
currently available for the IBA PC (excluding, of course, 
speed and data storage advantages provided by a 16-bit 
aachine.) Bottom line: this is the systea MOVATARI, and 
Current Notes, will use to saintain club records. 


GynFile+ Packaging: [0M Compatible?, The first thing 


one notices about Syafilet is the packaging -- which is 
sigilar for all the SYNAPSE series. he program is 
delivered ina foraat which IBA has sade popular: an 
attractive cardboard box encasing a three-ring notebook 
binder which holds the docuaentation and the prograe 
diskettes. The documentation is first class. Jt not only 
looks good, but is also well written. Iwo disks are 
included. One is the Prograa Disk, it contains all the 
code needed to run Syafilet. The second disk is a 
Tutorial, written in BASIC, that covers everything you 
need to know to use Syefiles. The binder, the 
docusentation, the provision of the tutorial -- all are 
indications of a quality product. Only the fliasy nature 
of the outside cardboard box hints at the fact that this 
1s a “poor aan's* DBMS. 


Learning SynFile+, The authors have structured the 
manual in the fora of a tutorial that gently walts the 
user through the step-by-step creation of a deaonstration 
database. In spite of the fact that the aanual is quite 
good, aost users will never read it. Most users never 
read any sanual. The tutorial disk, however, will be 
used. Stick it an, turn on your ATARI, and there you have 
your own private course. An initial aenu lets you choose 
between Database Introduction, Creating and Editing Fores, 
Entering and Retrieving Records, and Listing and Labeling 
Reports. As you work through the tutorial, the systea 
sigulates the operation of SYMFILE*. Instead of entering 
coasands or data however, you press the space bar and the 
tutorial does all the typing for you. 


SyaFilet is not difficult to learn. By the time you 
finish the tutorial, you ll be ready to go. After you 
Create one, of perhaps, two databases, input some data and 
produce soae reports, you will be an accomplished Syafile+ 
user. When you learn how to create new databases froa old 
descriptions and serge data froa one file to another, you 
will be a Syafile expert. 
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Learning SyaFilee 1s certainly facilitated by the fact 
that Syafile# is a siaple prograe to use. The system is 
menu driven: you're presented with various choices; use 
the cursor keys and select one. If that choice leads to 
another senu, it “pops-up* iemediately and you sabe 
another selection. If the choice requires you to provide 
information, such as the nuaber of characters to reserve 
for a particular ites, you are proapted appropriately. If 
you don't like any of your choices and want to step back 
to the previous senu, siapiy press the ESC key. 


1 do mant to leave the iapression that Syefilet is easy 
to learn and easy to use. However, let ae provide a saall 
Caution here. It's not perfect. ESC doesn't back you out 
of achoice in every instance. There are tiaes when you 
have to throw in sose garbage answers to get to a screen 
where ESC works. Similarly, there are other instances 
where | have run into little annoyances that I wish had 
been handled differentiy. 1 mill point thea out as | go 
along. 


Using SynFilet, | mant to give you a feeling of how 
SyoFile* works by using it to create a sisple database, 
for exaaple, one that keeps track of your check-writing 
activities. Put in the Prograe Disk (no BASIC, SyaFiles 
1s written in FORTH), and turn on your ATARI. When you 
finally see the initial SyaFile# screen (70 seconds), the 
bottom line of the screen presents you mith three choices: 


FILES RECORDS KEFORTS 

The MAIN, MENU. ~=There are only three initial choices. 
FILES deals mith choosing the file you want to work with 
and includes any of the standard tile handling comaands 
(copy, renaee, format, etc). RECORDS is used to saintain 
your database (insert, delete, and change records), 
REPORTS is used when you want to generate a list of 
informaticn or preparing mailing labels. 


When you start, the FILES option is highlighted. Press 
RETURN and a “pop-up aenu® detailing the available FILE 
options appears: 


Open Subtile Density 


Close Merge Format 


Copy Rename Delete 
DIF->SynFile SynFile- DIF 


File Options. The OPEN option is highlighted. Before 
you press return once aore, let's look briefly at the file 
options. The seaning of Copy, Renage, Delete, and Foraat 
Should be fagiliar to anyone who has worked with disk 
files. Density. Yes, Syafile* does work on either single 
or double density disks (although 1f you have two or aore 
drives, all aust use the sase density. 72??? What a pity’ 


} can't use an old B10 (SD) with a new INDUS. (DD) 


The “DIF* (Data Interchange Format) options are used to 
send data to another prograe (SYWFILE->DIF) or to input 
data fro another program (DIF-)SYWFILE). Syafilet allows 
transfer of data. How fast 15 another satter. | wrote a 
prograe to convert a FileManager 800 database of 150 
records (mith twelve fields) to DIF format. 1 then used 
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the Syafile* opticn to convert this DIF file into a 
SyaFilee file. Although it morked, it took one hour to 
coaplete the conversion. In the time it took to write ay 
conversion progras and then run it successfully, 1 may 
very well have been able to get the tasb done quicker by 
tust rekeying in all the data. 


(Note: | had planned to include ay conversion prograa 
in Curreat Motes. However, | discovered that SYNAPSE «ill 
have a conversion utility to aove FileManager 800 files 
directly to SyaFile# files by the tise you read this. 
They mill aake that disk available free to ATARI User 
Groups. ) 


Subfile is used to create a subset of an existing 
database and Merge 15 used to combine one database mth 
another (similarly structured) database. before anything 
can be done to a database, it aust be “apened*; you sould 
use the OPEN option. When you are done using a database, 
you use the CLOSE option. 


Creating a Database. he first step in creating a 
database, therefore, would te to use the OPEN option under 
FILES. ress RETURN and, normally, a list of all the 
files on your data disk appears. Initially, there are no 
files on your data disk. In fact, the Progras Disk 1s 
still in the dish drive. The only thing that appears on 
the screen 1s: 


# CREATE # 


If you had placed a data dish in the drive before you 
tried the OPEN option, all the data files on your dish, as 
well as the CREATE option, would have been listed. You 
would ove the cursor to the file you wanted to open and 
press RiTURN. lo create a new file, you choose the CREATE 
option, 


Unfortunately, the CREATE PROGRAM 15 not in the a@ain 
SYNFILE prograa. Therefore, if you have a data disk in 
the drive and you want to create a new file, you have to 
remove the data disk and insert the Prograa Disk to load 
Create. Once it is loaded, you remove the Prograe Disk 
and put your data disk back in. After you “create” the 
structure for your new database, you save it to your data 
disk, remove that disk, put in the Program Disk, and 
reload Syafilet, All the otner features in Syafilet are 
in the gain progras. If only SYNAPSE could have fit 
CREATE in as well, the user could have avoided al} this 
disk swapping. Unfortunately, 48K does have its liaits. 


Why not put the data dist in drive 2 and keep the 
prograa disk in drive 1°. Another ‘“untortunately.° 
SyaFile* will only open data disks on drive nuaber 1. 
This 1s ane of those little annoyances. 


The Create Menu. Once CREATE 1s loaded, another sub- 
menu appears above the FILES option: 


Edit form SynFilet¢ 


The names of all files on your data disk are listed 
above the eenu (in this case nothing is listed since 


SynFile+ Review 


rurrent NOtes 


@» 


nothing is there). Create fora is highlighted. Press 
RETUKN and a proapt appears in the senu window ashing you 
to supply a name for your database. Enter anase and 
press RETURN. Now you are greeted with an essentially 
blank screen, It's time to define the tora you would like 
your database to take. 


Designing a Database Fora, leagine your database as a 
sheet uf paper with one row of inforaation tor every check 
you write. You have six coluans labeled “Check WNo.", 
"Date", ‘lo:*, “Asount*, ‘“Itea", and “Code.* Everytiae 
you write a check you mould fill in another row on your 
paper. Each row represents a separate RECORD. The coluaa 
headings are called FIELDS. ach field represents soae 
itea of inforsation, pertaining to a specific check, that 
you wish to record, Sone iteas are dollar asounts 
(Asount), soe are textual information (To, Itea, Code), 
soae represent integer nuabers (Check No.), and some aay 
be dates (Datel. The first step in creating a database 15 
nothing @ore than specifying the nuaber and type of iteas 
(FIELDS) we want to keep in our database. This 15 what 
the CREATE option does in Syafiler. 


Posityoning the Fields. A fora is used to define a 
database. You start with a blank screen of 21 rows and 60 
coluans (the screen scrolls left or right as needed 
showing you 40 of the possible 60 coluens at any one 
tise). Use the cursor keys to eove wherever you want the 
first itea in your database to be displayed on this tora. 
When you are at the position you want, type in a name for 
this first field (Syafilet allows up to 66 fields). The 
nase can be anything you want (up to 31 characters) and 
will be the nase you use to refer to this ites later for 
creating reports. Press RETURN and another sub-senu 
appears: 


Cumulative 
Record # 
Counter 


Numeric 
Look-Up Dollar 


Date Integer 
Conditional Computed 


SynFilet Field Types. You may use any of eleven 
different field types to characterize your data. The 
aeaning of Text 1s obvious. SynFilet allows up to 255 
characters ina text field. IJnat’s over three lines on aa 
B0-coluan page. Plenty of space if you'd like to keep 


free-fora comments in your records. 


Nuabers can be stored as dollar amounts (Bollar), 
integers (Integer), deciaal nuabers (Muperic), or coaputed 
values (Computed). This last type lets you define one 
tea in your database as a function of other iteas. The 
definition can include the usual aritheetic operators (+ - 
# /) as well as six Syefie* functions (ABS, SORT, 106, 
LOG10, EXP, and EXPIO). 


The Conditional field lets you define a text field as 
being conditional on another field in the fore. for 
exaeple, you aight have a field called BALANCE which could 
display as either “Profit® or “Loss depending on whether 
the value in sowe other field was greater than of less 
than zero. 
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The Date field type mill autosatically foraat as 
_/ /)_ to hold the aonth, day, and year. In addition, 
when you are entering data, the contents of the date field 
will re@ain constant with each new record as new records 
are entered. Thus, you can enter today’s date on the 
first record you insert and that date will automatically 
be carried forward for every record you enter until you 
explicitly change it. 


The Look-Up field can be particularly useful. It 
represents a text field where you specify, in advance, all 
of the allowable entries. For exaaple, if you are 
recording student schedules, the nuaber of possible 
Courses 1S fixed and known beforehand. You could record 
all the course titles in a look-up table. When records 
are being inserted, only values in the look-up table mould 
be accepted for this field. In fact, if you press the 
ATAR] key (normally gives you inverse video), the per- 
gissible values for the look-up field are autoaatically 
displayed. When you see the one you want, hit RETURN and 
it is entered' If you do not enter anything into this 
type of field, the first value in the look-up table (the 
default) is automatically entered. 


The Record @ and the Counter field types are also 
useful. With Record 6, ‘ide? will autosatically insert 
an integer (starting wit and increasing by | up to a 
saxigua of 32,767) for every new record you insert into 
the database. The Counter field type allows you to 
specify the starting nuaber (between 0 and 999) and the 
incresent (1-100). . 


A completed input fora for our checkbook database aight 
take this appearance: 


CHECK NO.:; 


Changing Your Wind. Avery useful feature of foras 
design in Syafile* 1s that you are not stuck with your 
initial layout. 4 you want to sove any particular itea, 
just gove the cursor to the first letter in the item nase 
and press RETURN. Another sub-eenu pops up. This one 
lets you either MOVE the ites, give it a NEW WANE, a NEW 
TYPE, a WEN LENGTH, or just DELETE it. If you choose to 
aove it, the item nase and it’s field are changed to 
inverse video. You use the cursor keys to aove this 
field. When you are happy with your new position, siaply 
press RETURN and the field 1s soved peraanently. 


Mote: even after you have created your fora and in- 
serted records into your database, you can Change the fore 
by using the EDIT FORM option. Moving a field or changing 
its nase or changing the length of a numeric field can be 
accoaplished without aking any changes in the database. 
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Other changes, such as Changing field length of changing 
the type of field will require you to save your “revised® 
fora under a new database name. Ihe infor@ation in your 
original database can then be transferred to the revised 
database by using the Syafile* MERGE option. 


Indexing Your Database. When you return to Syafiler 
and open your newly created database, the first thing 


SyaFile? requires 1s that you choose one or sore indexes. 
Syafile* keeps track of your records by creating an index 
on one (or aore up to a eaxigue of 16) of your fields. If 
you try and retrieve a record based on the contents of a 
field in your index, the retrieval is very Quick -- 
SyeFile# knows exactly where the record is stored on disk. 
lf you retrieve arecord based on a non-indexed field, 
Syafile* has to search through every record in your 
database to deteraine whether the record aeets the search 
criteria or not. Index on the fields you will later be 
searching on. 


When you list your data, it will appear sorted 
(ascending of descending, whichever you prefer} on the 
index fieldis). if you want your data sorted by sose 
other field, it is a simple matter to re-index the file on 
whatever new field(s) you want. 


Entering Records. Entering data 1s siaplicity itself. 
Open the appropriate file, move to the RECORDS option, and 


press RETURN. You will see the following sub-menu: 


Update all Re-index 
Delete all 


Retrieve 


Enter 


REPORTS 


Select Enter and the fore you just finished designing 
appears on the screen. Fill it in. You can use the cursor 
control keys to juap from tield to field saking whatever 
Changes you like until you are satisfied you have the 
correct data entered. Press START and the record 1s 
autosatically inserted into your database and a new blank 
fora appears. Enter as @any records as you like. 


Retrieving a Record. Choose the Retrieve option and, 
Once again, your blank tore appears. You specify the 
records toretrieve using this blank fora. For exaaple, 
if you wanted to recall check nuaber 123, you would enter 
"123" inthe “CHECK NO.* field. Only the record that had 
a value of “123* under check nuaber would be retrieved. 
If you wanted to retrieve all checks that were greater 
than $100, you could aove to the AMOUNT field, press the 
*)* syabol and then enter then nuaber 100; only checks 
with asounts greater than lor equal to) $100 mould be 
retrieved. 


Search Criteria. If you want an exact aatch, enter the 
aatch you want in the appropriate field. You can also 


request iteas less than or equal to “<*, greater than or 
equal to *)*, or not equal to °#*. Note: you cannot 
specify arrange asa search criteria, e.g. “greater than 
50 but less than 100°. 


On text fields you can use the asterisk (#) as a wild 
character. Thus, “A** would sean anything that begins 
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mith the letter A, “#AD.* would eean anything that ends 
mith the letters "MD.", “#ATARI#* would aean anything that 
has the letters “ATARI” anywhere in the text field. 
Ranges are similarly not available in text field searches, 
@.g. you can not request itees “greater than B and less 
than D.° 


You can search on two fields at once, for example, find 
all checks » $100 AND code = “CL*. In fact, Syefiler 
allows you to search on up to 16 different fields at once. 
When aultiple fields are used, you specify whether to use 
AND or OR in satisfying the search criteria. 


Updating a Record. when you retrieve a record, the 
fora you designed 1s displayed on the screen with the data 
relevant to that record. “Update’ is the default aode. 
If you want to sake a change, aove the cursor to the 
appropriate field and change it. When you go on to the 
next record, the changes you aade are automatically stored 
on the diskette. 


A particularly nice feature of Syafilet is the aultiple 
update capability. Suppose you had recorded LWC in the 
“To” field on a nuaber of different checks. Now you want 
to ga through your database and change “LWC* to be ‘Local 
Water Company". You would use the UPDATE-ALL option. 
Enter a search criteria that would identify all records 
with a “To* field value of “LWC*. Another blank fore 
would then appear in which you would enter any changes you 
wanted to eake. Enter the new expression in the ‘“To* 
field. Press RETURN and all the relevant records in the 
database are updated. 


A. itiple delete capability 15 also included. [f you 
specify a search criteria “Date” < "12/30/84", every entry 
mith a date prior to 1985 would be deleted. This could be 
an incredible time saving feature. Of course, if you aake 
a eistake and forget to put in any search criteria, every 
record in your database is deleted. Gut since you eade a 
back-up af your data dish, there is noreal hare done. 
You do aake back-ups, don't you” 


Reports in SynFile+, I'd love to be able to say that 
SyaFile# gives you any bind of report you'd like to have. 
But flexibility in report foreatting 1s one of the 
features that comes only with the higher-priced DBMSs. 
There are only three different ways to look at your data 
using SyaFilet#. You can exagine (and print) an individual 
record, you can print a ‘“list" where every line 
Corresponds to a record, or you can aake up “labels” where 
the positioning of iteas is up to you. 


Individual Records. The printed version of your 
individual records mill look exactly like the fore you 
designed. Field names as well as the data in the field 
are printed on paper in the precise locations you designed 
into your fora, To print a record, you first retrieve it. 
When it is displayed on your tereinal screen, press the 
OPTION key and a sub-senu appears offering you a choice of 
printing the record, calculating the record, or deleting 
it. If you choose FRINT, the record 15 printed on your 
printer. (The calculate option 1s used to force Syafile¢ 
to calculate "computed" fields and allow you to view the 
results defore the record is saved.) 
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Printing a List. both the list and label reports are 
found under the KEPOKIS option of the Main Menu. iT 
produce alist, you enter the nase of the field you wan 
listed una “print format line." You say include up t 
40 field names (coluans) up to a total of 232 characters 
The field names become the coluan headings. If you appen 
a “*" to nueeric field nases, Syafile* mill calculate 
coluan-total and print it at the bottoa of your list. 


SyaFilet mill automatically deteraine the amount of 
spaced needed for each field (the greater of the fiel 
length or field name). However, you can change thi 
default setting by repositioning the field name on th 
print format line. For exaaple, if you wanted to leave a 
additional five spaces between the first and second field 
in your list, you would sove the cursor to the beginnin 
of the second field nase and use the CWIRL - INSERT ke 
Coabination to insert five blanks. 


You can send your list (or labels) to the screen, to ¢ 
disk, or to the printer. If you send your list to th 
screen, however, you will only be able to see the first 4 
coluans. The screen does not scroll to allow you to se 
any data beyond coluan 40. 


If you choose to send the list to printer or disk, you 
Can specify the total page length and include a repor 
title. The page length feature e:ll print the auaber o 
lines you request and then eject to a new page, print th 
Coluan headings again, and continue on with your list 
The r.sort title only appears at the beginaiag of you 
list and is not repeated on every page. You caa use th 
report title to send any desired printer codes (ta 
exaaple, to turn on condensed print) to your printer. 


The Labels Option. When you select the labels option. 
Syafile# gives you a screen very siilar to your initia 
create fore screen, ove the cursor anywhere on th 
screen and position fields wherever you like. Tha 
function is used priearily for generating aailing label 
but can have other uses as well. You are allowed an 
arrangeaent of fields on an 80 coluan by 21 line fore 
The left eargin, lines between labels, and the coluan 
between labels can all be set froa 0 to 999. Up to 32 suc 
foras can be printed across the page. 


Syafile# allows up to 32 fields to be displayed in | 
label. A trating *,* concatenates adjacent field dat 
and) prints a comsa and a space. A trailing °< 
Concatenates adjacent field data and puts a space betuee 
the data. 


After you define your label placement, and indicate th 
nuaber of labels on a page and the desired coluan and lin 
Spacing, you are allowed to indicate any desired searc 
criteria. Finally, you select PRINTER, DISK, or SCREEN t 
receive the output. You cose back to this choice afte 


your report is finished in case you want to send it t 
another device. 


If your initial label design was not quite correct, 
that's too bad. Because SyeFile* does not reseaber wha 
you specified for your list or label entries. If you g 
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back, the print foraat line for lists and the screen for 
labels 1s blank. This 1s another sajor annoyance. You 
seldoa get things right the first time. = If SyaFile¢ 
reseabered your last selections, ali you would have to do 
is edit it to aake any desired changes. 


SynFilet Utilities. This review has already gone 
longer than I would have libed. Sol will not dweli on 
the various utilities. | mil say that it 15 possible to 
use the DIF option to aove data trom other systeas into 
Syafile. The data coses in with tields nased “A*, “B*, 
"C*, etc. and with a ainimue text field length of 16 
characters after conversion. You can use the edit fore 
option to change field nages. If you want to change field 
lengths as well, you have to define a nem database with 
the sase naees as that in your original DIF conversion and 
then use the MERGE option to combine the two. Although it 
ail can be done, it will tabe a good deal of tise and lots 
af patience. 


You send Syafile* reports to ATARIWRITER by sending 
your report to a disk file and then later using the eerge 
option in ATARIWAITER to include that disk file in your 
ATARIMRITER prograa. | have not tried this option. 


Conclusion. | have covered the use of Syafilet in great 
detail. If you were already familiar mith File Manager 
800 or Data Perfect, this review should give you a good 
idea of the relative aerits of Syafilev. If you never 
used any DBMS, you should by now have a pretty good idea 
of just what one does. is Syafile# worth it? Jo sose 
people, YES; ta others, NO. 1 do know that with the 
recent reduction in prices, the proportion of people who 
will conclude ‘“YES° will certainly increase 
substantially. 


ee * 


SYNCALC 
BY SYNAPSE, DISK, $69.95 


Reviewed by Jack Holtzhauer 


SyaCalc, one of several integrated applications proraas 
recently developed for the ATARI by SYNAPSE, is an 
“advanced electronic spreadsheet". So what's an 
electronic spreadsheet and why do | need one? 


Electronic Spreadsheets. Very siaplisticly, | guess a 
Spreadsheet aight be coepared to a large piece of graph 
paper, each square (or cell) of which can contain text, 
Muserical data, or a foraala used to calculate a nueerical 
result. The 128 coluans on the Syalalc spreadsheet are 
identifed by letters running from Ato Dl. The rows are 
identified nuserically and fun from 1 to 255, providing a 
Batrix of 32,640 cells. Individual cells are identified 
by their coluan/row coordinates. The cell at the inter- 
ection of coluen A and row 1 is cell Al. The cell at the 
intersection of coluan Wand row 42 is cell 42, ad 
infinitue. 
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A simple use of a spreadsheet @ight be to calculate the 
area of a circle by inputing the radius (ky in cell Al and 
the foraula Plei(al)°2), or Fien?, an cell A2, Upon 
calculation, the area of a circle mith the given radius 
would appear in cell a2. Adaittedly, not @any uf us 
would use a Spreadsheet tor such a purpose, but suppose 
this was just the first step in a series of Complex engi- 
eering calculations you wished to pertore tor a wide range 
of radii. By serely entering your complete series of 
toraulae on the spreadsheet, you Can pertor® your 
repetitive calculations by eerely Changing the single 
value in cell Al. 


Personally, | have tound spreadsheets to be an inval- 
able aid in handling family rinances. Several days after 
] retired back in 79, ay mite stormed out of the house 
suttering the old gag line “for better or tor worse, but, 
dasait - not for junch'* 1 had been under her feet 
“systeazing”’ her kitchen by alphabetizing all the little 
spice cans, etc. To keep ee at area's length, she promptly 
got a job selling new hoaes for a major builder. She nom 
earns both salary and cosaission income, part of which 1s 
invested in Company stock, employer sponsored autual 
funds, and a couple of tax dodges. Projecting tax liadil- 
ty with all the employee expense deducticns, auto costs, 
401K incose exclusions, investeent fund earnings, capital 
gains (and losses), etc., was areal hassle. | solved the 
problea by duaping all the applicable IKS ftoras onto 
SyeCalc spreadsheets. Now, once a aonth, | aerely enter 
our newly projected anual ipcoae and related data on the 
applicable sheets, and all the calculations are updated 
for ae. 


In short, to quote trow the first page of its asnual, 
SyeCalc *. . . can function like @ business or scientific 
worksheet, combining the convenience of a pocket calcula- 
tor with the powerful aemory and electronic screen Capa- 
bilities of the personal computer." As illustrated in the 
siaple exaasple given above, it s great tor “what if* types 
of forecasting or planniig analysis and there are a nuaber 
of books on the aarket describing a wide variety of poss- 
ible ways by which the hoae computerist can @abe use of a 
spreadsheet progras. More on these later, but first - - - 


Documentation. Ihe one-disk SyaCalc prograe coees 
packaged in a 9x? three-ring vinyl covered loaseleaf 
binder with a rigid cardboard dust cover. The docueen- 
tation, Consisting of over 140 pages, includes a folding 
coseand quide which can be resaved froa the binder for 
ready reference. The instruction anual itseli 1s divided 
into three parts (no intent to plagarize the first sen- 
tence trom Ceasar’s ballic Wars). A general introduction 
1s followed by a two-part tutorial which steps the new 
user thru the intricacies of the progras. The final sec- 
tion, some fifty pages in length, provides a detailed 
description of SyaCalc comeands, functions, error aess- 
ages, etc., and offers a few nints OM Saving space and 
laproving speed of caiculation, An index is also 
included. 


Hardware. Svstea requirements include 48K and at least 


one disk drive twill support two, If booted on a non-IL 
ATARI, you ll have 7S* free KAM for progras use, but only 
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[IK if using an IL) (increased to 25K af Translator Dist 
ssed). Tre prograa will also recognize the presence of an 
Acton Kaspower 128K or Mosaic 64) Select board, giving you 
the extra RAM to play mith. (Available at L&y 
Eiectromics, Woodbridge, VA., at $49.95 with an addit.onal 
Sk disccunt for users’ group aeabers presenting ID cards. 
Incidently, Jona Linton of L&Y reports SYNAPSE will 
provide a Dack-up disk for $20.00 upon receipt af your 
maffanty Card and proof of purchase.) 


A couple of aajor features af the SyaCaic, Syafiler, 
and SyaTrend/Graph prograas before we go any further. All 
three can produce data interchange foreat files (DIF 
files) tor use by ats sister prograas. In addition, Sya- 
Calc and Syafile* can produce text files for use mith 
ATARIWRITER. This gutual compatibility provides the user 
with a fairly powerful package of integrated word-process- 
ing, spreadsheet, database, statistical and graphing 
applications progr aas. 


SynCalec vs VisiCalc. The only other sajor spreadsheet 
pragras currently available far the ATARI is VisiCalc, and 
it aight be best to describe SyaCalc mith this in aind. 
How does it compare to the ATARI] version of the VisiCalc, 
the godfather of all spreadsheets? Very well, indeed. It 
has ali the features of ay first-generation ATARI Visi- 
Calc, mith some added ingredients. SyaCalc includes the 
Statistical functions saaple ean, saaple standard devia- 
tion, sSaaple variance and range (difference between the 
@iniaua and gaxiaue values within a range), all features 
aissing from VisiCalc for the ATARI. Unlike VisiCalc, 
SyaCalc also includes the logical function IF /THEN/ELSE 
and the financial functions needed to compute the future 
value af an annuity or a loan payment, given the princi- 
pal, interest and tera of the loan. SyaCalc mill even 
sort alpha ar numeric data for you and, if you wish, dup- 
licate it in its new configuration elsewhere on the sheet, 
or merely replace it trom whence it came. Text entry is 
also easier. WissCale pereits text entry only cell by 
cell. If you're in a six space cell and mish to use a 
rine letter heading (label), you've gat to toggle to the 
next cell to enter the last three characters.  SyaCalc 
peraits teat entry to overflow to the next cell, and the 
neat, as necessary. The list goes on and on' Is Synapse 
confident their product beats the ATARI version of Visi- 
Calc? Could be. They've included a routine for those of 
you with VisiCalc tiles youd like to convert to SyaCalc 
toraat. 


SyaCalc is compatible mith most printers and, if desir- 
ed, will generate condensed or compressed type with the 
ATARI] 825 & 1025, EPSON, GEMINI and NEC/C.1TOH products. 


Working mith Byntalc. Mastering program execution 15 
not difficult. he user has three choices es to how he 
aight wish to execute acst faraatting controls or “DOQS* 
tuncticns. Two involve use of the aenu tree. The third 
1s the “expert «user's sade’. For exaaple, if you mish to 
change the width of coluan I to twelve spaces froa the 
defauit value of eight, you can use the aeenu tree to 
acco@plish your purpose. You first hit the OPTION key to 
display the four sub-menu selections on the bottoa of your 
screen, then the arrow keys and return to aake your selec- 
tion - COMMAND in this instance. The 16-1 tea COMMAND sud- 
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aenu is then displayed. You again use your arrow keys to 
toggle to WIDTH and hit return. You are then asked how 
Many spaces yOu wish in the coluen in question, 12 1n this 
instance. After responding to this query, you're asked to 
identify the first coluan in the range of coluans you wish 
to change. You can then aerely enter the coluan letter, 1 
in this instance (aenu/keyboard entry aode), or toggle 
your screen cursor to coluen I and hit return (eenu/cursor 
point ode). You identify the last coluan in the range in 
a sigilar fashion, and your @ission is accoaplished. 


Does that sound complex and tiae consueing? Maybe so. 
But you can accoaplish the saee purpose with only six 
keystrokes using the expert user's sode - “/FWI2K", slash 
for expert user's mode, F for foraat, W for width, 12 for 
value and i for coluan involved. Incidently, as you 
toggle through either of the eenu comaand sodes, the 
appropriate expert user's coamand 15 displayed in the 
upper left-hand corner of the screen - a feature sost 
helpful to the new user. 


Function Syasary. Inasauch as this article is seant to 
be an overview, not a tutorial, 1'@ going to close by 
aerely providing you with a listing of ost features, 
functions, and foraating controls SyaCalc aakes available 
to the user. (See accompanying table.) Readers generally 
familiar with spreadsheet prograas aay find this helpful 
in analyzing the coapletness of the package. 


References. But others aay still be wondering whether 
a spreadsheet prograa aight be worth an outlay of fifty- 
bucks. If so, your local public library 1s probably 
stocked with several of the scores of books written on 
this subject. One such tose, written by Donald H. Bell 
and published by RESTON ($14.95), 15 The VisiCalc Boot, 
Atari Edition - - - an in-depth tutorial on the use of 
VisiCalc, It includes a sixteen-page bibliography on 
spreadsheet publications. Stanley R. Trost’s Posog 
Business mith VisiCalc, published by SYBEX at $11.95, 
offers a compendiue of uses for spreadsheet progr aes 
ranging froma siaple checkbook register to a Seasonal 
forecast of retail sales.  WissCale Wone and Office 
Coppanion, written by Castlemitz, Chisausky and Kroaberg 
and published by OSBORWE/ACORAW-HILL at $12.95, offers 
teaplates on such varied spreadsheet uses as cash flow 
analysis and EEO personnel reports. All of these 
publications can be easily adapted to SyaCalc use. 


Your needs aay be siepler or auch eore coaplex than 
aine. But why not give it atry. What's fifty-bucks. 
Who are we kiddin’ anyway. We all need sosethin to keep 
us off the street. And aren't our little coaputers just 
luke electric trains - toys for big bays! 
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DOS FUNCTIONS 


LOAD..... worksheet or data (DIF) 


SAVE..... worksheet, data or text (ATAKIWRITER) 
FORMAT DISK 


DELETE DISK FILE 
RENAME DISK FILE 
CONVERT VISICAL 10 SYNCALC 


FORMATTING CONTROLS 


Foraatting controls aay be used globally, or confined to 
a specific cell or series of cells: 


NUMERICAL AND TEXT 

JUSTIFY... left, right or centered 

MARGIN... fix wargin at lett of cell 

COLUMN WIDTH can be individually set froa! to 34 
Characters 

PROTECT.. protect cell of range of cell froe further 
foreatting commands or recalculations 

UNFROTECT reverses action of above comaand 


UNFORMAT delete formating controls troa cell of range at 
cells 


Nuaerical data Qdy Ge presented in poyr g0° Ord, toreats 
FINED ciateger), FLOATING, SCIENTIFES oy ENSINESRING. 

in addition, FINED and FiGATINE auebders Gay Oe further 

formatted by: 

SETTING SPACES 19 RIGHT oF DECIMAL FOINT 

PRECEDE WITH DCLLAK SIGN 

INCLUDE COMMAS 10 LEFT oF DECIMAL POINT 

TRAILING PERCENT SIGN 

EXPRESS NEGATIVES as: “, © >, OR Ck 


MATHEMATICAL FUNCTIONS 


ABS ATAN INT FI 
ACOS COS LN SIN 
ASIN EtP L06 SORT 

TAN 


STATISTICAL FUNCTIONS 


AVE...... averages a range of values 

See Counts the nuaber of nueeric entries within a 
range 

MAI... @axiaua value 
MEAN... ., sasple sean 
| PPE ainiaua value 
RNG....., range (between cin & wax) 
pee Sample standard deviation 
SUA...... sua Of values 
WN ok: Sample variance 
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Table is 
lc Features, Functions, and Formatting Co trols 


FINANCIAL FUNCTIONS 


Pe future value of an annuity 
a hopeiee net present value of a range of investaents 
Pela a's loan payaent 


CELL MANIPULATION 


<4 Are Copy contents, foraat and foraulas of « cell 
or range af celis to anatner cell or range of 
cells, 

MOVE..... cell or block of cellS to another position 


INSERT... rom or coluan 
DELETE... row or coluen 
ERASE.... cell or range of cells 


MODE OF CALCULATION 


Calculation may be set for either coluan or rom priority 
and, in addition, aay be either; 


AUTOMATIC recalcuiates after each entry, except 
PROTECTED cells 

MANUAL... recalculates Dy pressing STHAT yoy, eycegt 
FACTECED ceils 

FORCES... recalculat>s ali cells, incluging FeGtECiED 
Cells 


SCREEN PRESENTATION 


MINGOWS.. vertical or horizontal with shynchronized or 
independent scrolling 

TITLES... fix vertical 
fix horizontal 
fix both 

HEADINGS toggle on or off 


MISCELLANEOUS FUNCTIONS 


LOOKUP... allows user to set up table of values to 
detersine a second value (@.g., tax table) 

MN veins sort roms in selected range ia either 
ascending or descending order based on 
selected sort Coluan, and place at selected 
position on sheet 

PRINT.... dump any portion of sheet to aost printers; 


Compressed font on ATARI 8295/1025, EPSON, 
GEMINI and NEC/C.110H 


COMMAND WILD CARDS 


Rickey entire worksheet 
ekadiens bottom-right cell 
Shep eonap Current Cursor position 
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SynFilet: A Review 
by Rick Gier) 


In the 2 years or so that! have owned my Atari 
80@ | have been asked many times what Kind of 
computer | owned and what exactly do! doon it. It 
seems that about half the time, after 1] say I have an 
Atari, the person | am talking to says “Oh, so you play 
a lot of games, huh??" Well of course! play some 
games, heck even the people who use all those other 
computers play some games on them. Butit seems 
that most people, mainly those unfamiliar with the 
Atari, Know it only by reputation as a game playing 
machine. And many “serious” computer users look 
down on it as not being a “real” computer. 


Well lets faceit. the Atari IS possibly the best 
game machine on the market. It’s graphics and vig 
Capabilities are unmatched by anything even near it’s 
price. And there are many, MANY simply great games 
out for it. But the heart of the Atari computer is the 
6502 microprocessor t he same basic chip that is the 
heart of other “more serious” computers, such as the 
Apple J{ series. There is no real reason why the 
Atari could noi do most of the things other computers 
do. Things like Word Processing, Spreadsheets, Data 
Base Management, and other Business programming. 
Someone must simply sit down and write the proper 
programming for these applications. 


And that seems to be part of the reason why 
outsiders think of the Atari as simply a game machine: 
many of these other progtams are simply not being 
written. Or at least most of the programs being 
written for the Atari are games, with the tew 
“Business” programs being written either not up to 
par with “serious” business programs, or not getting 
the attention and advertising they deserved. There 
are several business-type programs out there for the 
Atari that are simply great -- but for some reason or 
other we do not hear much of them. Maybe the 
authors/publishers of other programs do not think 
that a “game machine” can generate the market demand 
for them to spend the money it takes to bring their 
products to the marketplace. For those reasons, +49 
perhaps others, we Atari owners are getting the shor 
end of the stick when it comes to “serious” computing. 
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Or, at least, that has been the case. Last yeara 


w series ams for the Atari was introduced. 
though it Ay some longer than expected time 


to get these programs into the stores, the Syn series 
from Synapse is now available. With these programs 
available, we are now a leg up on the rest of the home 
computer market. This series is made up of 3 major 
programs along with a few somewhat simpler 
additional offerings. The 3 main packages go by the 
names of SynFile+, SynCalc, and SynTrend. SynCalc is 
a Spreadsheet program (like Visicalc plus a lot more) 
and SynTrend is a visual Graphics and Plotting 
program (like B-Graph). These programs have been or 
will be reviewed elsewhere. This article will focus 
on SynFile+. 


Synfilet is a general database generator and 
maintainer. It allows the user to define a database 
to his own specifications and then maintain and use 
that data however he wishes. He can enter records, 
update them, delete them, or manipulate them in many 
different ways. “But", you ask, “what can | use it 
for?? I don‘t own or run a business and I can't see a 
use fora program like that!" Well, there are many 
uses for such a program aside from running a 
business. First of all you must tow what a datbase 
is: a data base (or database, whichever) is simply any 
organized collection of facts. It does not matter 
what those facts are or how/why they are organized. 
Databases exist in many shapes and forms all around 
us everyday. Possibly the best known and most used 
database of al] is the telephone book. It contains the 
names and phone numbers (facts) of the people who 
have phones in a certain geographical area, arranged 
in a certain order (usually alphabetical). Other 
databases are things like recipe books or files, 
almanacs and encyclopedias, and the card files at your 
local library. &ven your checkbook can be considered 
a database! 


SynFile¢ can do all of those things and more. 
Billed as “The Ultimate Filing System", it has more 
features than any other data base program for the 
Atari computer and, 1 am told, seriously rivals other 
data base programs such as Dbase Il. | am also told 
that it contains many functions usually found only on 
larger mainframe databases. Whether this is true or 
not, it is certain that SynFiletis a great tool for the 
Atari. So what makes SynFile+ so great? Well, from 
my Own point of view one of the biggest advantages of 
SynFile+ over other Atari data programs such as Data 


Perfect and Filemanager 800+ is its capacity. On a 

normal 48K Atari system you can maintain data bases 

containing up to about 2@5@ records with SynFilet, 
compared to about 738 records maximum = on 
Filemanager 800+ and a similar amount on Data 
Perfect. Although the maximum capacity for Data 
Perfect depends on how big each record 1s - actually, 
with very small records, Data Perfect can hold about 
as much as SynFilet. SynFile+, however, 1s not limited 
to small records to achieve a large capacity. Data 
Perfect maintains it’s entire data base in memory and 
only saves the data base to disk when you quit each 
session, it is effectively limited to 48K worth of 
program and data. The longer the length of each 
record the smaller the number of records possible. 
Both Filemanager 800+ and SynFilet us 2 oirferent 
method tokeep track of records. What they dois to 
maintain the data on disk while Keeping an INDEX of 

the data in memory. This index is Kept sorted and 1s 
basically the pointer information necessary to tell the 
disk drive exactly where to go to access any particular 
record. The biggest disadvantage to this system 1s 
speed; the program must locate in memory the index 
needed and then input the record from the disk drive. 
With the comparatively slow Atari disk system, this 
means some delay in accessing any particular record. 
The biggest advantage is that the capacity of the 
system is not quite as dependent on the length of the 
data record as is Data Perfect. This system of 
maintaining the index in memory 18, however, about 
where the similarity between SynFile+ and 
Filemanager 800+ ends. Whereas Data Pertect is in 
macnine language, Filemanager runs on Atari Basic. 
SynFile+, howe. “renin Forth. This gives it 
nearly the speed of machine language, and eliminates 
the need for the Basic cartridge, freeing additional 
memory for it’s use. In addition, SynFilet is not 
limited to a single single-density disk as is 
Filemanager 800+. SynFile+ supports single, enhanced 
(1056) or true double density drives. In addition, with 
SynFile+t your data base can stretch over up to 16 
disks. While Keeping track of which disk 18 which can 
get a little hairy, if you need it, the ability is there. 


SynFilet also has one other ability that the others 
don’t have: it supports both the Axlon Ramdisk and 
the Mosaic 64 Select boards. Yes, | know, 
Filemanager 800+ also can use the Axlon Ramdisk, 
But what Filemanager 860+ does is to load your data 
base from the disk drive into your Ramdisk and then 
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use the Ramdisk for faster access, While this 
great tor access speed, you are st li amited to abk 


worth of data storage (the size of a single density 
dish). SynFile+ uses this additional memory to 
maintain the index of your records. When combined 
with the ability to stretch files over 16 disks, this 
means LOTS of records possible. While it will 
support the Axlon Ramdisk, it will also support 1, 2, 
or 3 Mosaic 64K Select boards. Togive you some 
idea what this means in relation to capacity -- with 3 
Mosaic 64K Select boards in an Atari 866 (192K) you 
can maintain a database of up to 34,813 records, 
depending on how you index it (The figure of 34,813 
was obtained using a look-up field as the index). That 
18 probably many more records than 99.99% of the 
users will ever need!! 


In addition to the capacity in terms of the number 
of records, the program also has a lot going for it so 
far asit’s general capabilities are concerned. For 
instance, each record can contain up to 46 fields. And 
the field names can be up to 31 characters in length. 
The field names canuse all valid ASCII characters 
except “(" and")*. Your created data base 1s “free 
form” in that each field canbe positioned, and moved 
if desired, whever wanted. And it is not limited to 
the size of your TV or monitor screen: the form size is 
8@ characters by 214 lines inclusive of field names. 
With SynFile+ you scroll a 4@ column window over 86 
columns. Unlike Filemanager 80@+, though, it is 
lumited to a single 66x21 page. 


Another strong point for SynFile+ is the large 
number of field types allowed. These types include 
the following: 


i. TEXT -- up to 255 characters in length. 


2. NUMERIC -- fixed or floating point ranging from 
—9x 10197) to 9x 10197). 


3. CUMULATIVE -- to Keep a running total of values 
contained in other fields. 


4. LOOK-UP -- This field will contain an entry from 
a table of text data, limited to 34 characters and 
automatically right sstified. 


5. DOLLAR -- Automatically right justified with 6 
sign and decimal point. Up to $999,999,999.0@ without 
exponential notation. More with. 


@) 
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6. RECORD ® -- an automatic ascending sequential 
number supplied by the computer, starting with 1 and 


goeing up to 32767 in increments of | with each new 
record. 


?. DATE - month, day and year in format 
mm/dd/yy. System supplies slashes. 


6. INTEGER -- whole numbers ranging from -32768 to 
+32768. 


9. COUNTER -- same as record number except that 


user supplies the starting number (6-999) and 
increment (1-16@). 


1@. CONDITIONAL -- designates that the field will 
contain a particular text entry depending on a 
conditional relationship defined up to 34 characters 
long. 


11 COMPUTED -- Based on formula you define. 
vp nth +,-,%,/, ABS, SQRT, LOG, LOGI6, ay, and 
10. 


Even with this large number and variety of field 
types, SynFile+ is actually very easy to use. Like 
Filemanager 806+, and unlike Data Perfect, it is menu 
driven. Unlike Filemanager, howeverm the menus an 
SynFile+ donot cover up your data by taking up the 
entire screen. Usually in fact the menus take up only 
the bottom couple of rows, leaving the rest of the 
screen visible. For instance, when first booting up 
the program all that shows is 1 line accross the 
bottom of your screen -- the main menu. By using the 
right and left cursor Keys you move the “highlight® to 
whichever of the 3 main menu choices you wish to use: 
FILBS, RECORDS, or REPORTS. Then simply press 
the (RETURN) key. When initially booting up, your 
choice will be "FILES" as you must load a file before 
you can work on it. 


Immediately after pressing the (RETURN) Key you 
will see the Files Sub-menu. This sub-merw contains 
many options including: 


OPEN SUBFILE DENSITY 
CLOSE MERGE FORMAT 
COPY RENAME DELETE 
DIF-Syn Syn-DIF 
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The first option, OPEN, will automatically be 
highlighted when the sub-menu comes up. By simply 
pressing the (RETURN) Key at this point the program 
will look out to disk drive 1 to see what SynFile+ 
files are there available to be loaded. This brings up 
4 point worth mentioning. Unlike Filemanager 660+, 
SynFile+ is a single load for normal usage: once loaded 
the SynFile+ disk is not needed, leaving the disk drive 
free for use by the data disks. The system works very 
well; you don't have to worry about “swapping” disks 
lita you do with a single drive and Filemanager. 
There is one exception to this -- the “CREATE“ 
module, needed to create or modify a data file form, 
must be loaded seperately when it is needed. In other 
words, if you wish to create or modify a form you must 
be prepared to have to Swap your SynFile+ disk and 
your data disk once or twice. But other than for that, 
once the program is in your computer it does not need 
to go back to the program disk. 


With a data disk in drive 1, when you highlight the 
“OPEN" option and push [RETURN] you will be shawn 
4 listing of all SynFile+ files on your data disk. Once 
again, by simply using the cursor control Keys you 
select which you wish to load, or specify “CREATE*. 
The essential parts of your form will be loaded into 
the computer and set up, along with the index of your 
data. When the load is completed, displayed accross 
the top several rows will be information on the loaded 
file. This includes the datafile name, the index 
length, the number of records the file contains, and 
the capacity of the file based on memory size and the 
index length). Also showing will be the indexed fields 
in the order in which they are indexed as well as their 
index length and the main mem. At this point, with a 
tile loaded, it is time to do something with it. If we 
Change the main menu to “RECORDS* and press the 
(RETURN) key we will get the “RECORDS sub menu. 
This menu includes the following options: 


RETRIGVE UPDATE ALL 
RE-INDEX ENTER 
DELETE ALL 


Once again, by using the cursor control keys and the 
CRETURN) key we can select the operation we wish to 
perform. As“RETRIEVE" will probably be the most 
used function, it is the one 

automatically highlighted. 


1 don’t want to take the time to 9° into detail 
about these options, but | do want to mention 3 things 
at this time. First, when using "RETRIEVE" you will 
be asked to apecity search criteria. By simply 


pressing the START button you specify ALL records. 
And to get each subsequent record, yOu again press 
the START button. Second, SynFile+ will 
automatically position the cursor at the start of the 
next field needing data. It starts at the upper left 
Corner and proceeds left to right, top to bottom. 
Whenever you press the (RETURN) Key, whether or 
not you have actually entered any data into that field, 
it will sump to the next field. If it is at the last field, 
it will sump back up to the first field. And it moves 
FAST. Third, whenever you are in the “ENTER"* or 
“RE TRIE VE" modes, if yOu press the OPTION button a 
new menu comes up allowing you to PRINT, 
CALCULATE, or D&LETE the record. If PRINT is 
selected, the entire record exactly as shown on the 
screen will be printed out to your printer, including all 
field names. 


There is still so much more to mention about this 
Program’! But not enough time todo it, so | will 
merely touch on some of the highlights. For instance, 
you can do searches on multiple fields with the 
Options AND or OR. You can also use wildcards for 
text searches, as well “greater than", “less than”, or 
“not equal to”. When doing reports you can use either 
4 ‘LISTS* option or a “LABELS* Option and can output 
to aprinter, a disk, or the screen. When using the 
“LISTS* option you use a PRINT FORMAT LING to get 

output lined up exactly how you wish. And while 

documented (at least, I did not see it) you can use 
the TITLES and HEADING portion of “LISTS* to output 
Printer control characters to your printer. "LABELS" 
al you to format your output in a different 
manner; you can for instance specify up to 32 labels 
accross, with a left margin of 0-999, 0-999 columns 
between labels, and 0-999 lines between labels. 
Using a trailing *," concatenates aducent field data 
and prints out a comma and a space. A trailing *<“ 
concatenates and puts a space. Of special 
significance are the DIF routines and the SynFile+ to 
AtariWriter abilities. DIF (Date Interchange Format) 
allows for the flow of data between BynFile+ and 
other programs. For instance, You can send data tiles 
from SynFile+ to SynCalc or Visicalc. Or can load 
data into your SynFile+ from either. In addition, you 
can input data into SynFilet from ANY source if that 
Gata is put into DIF format. For example, Mark Spires 
and | have written a Filemanager 606+ to DIF 
converter that allows you to transfer files from 
Filamanager 600+ to SynFile+ without having to retype 
the data. This program is Public Domain and 
available upon request. If demand is there, it will be 
made available to our Library. Last, but far from 
least, is the ability of SynFile+ to do database merges 
with AtariWriter. The story we have heard goes that 
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when AtariWriter was presented to Atari management 
for approval they decided that it was too complex and 
wanted some features deleted. Rather than delete 
the features, reference to them was Simply left out of 
the documentation. SynFilet uses one of these 
otherwise undocumented features to allow a database 
merge resulting in, among other things, the possibility 
Of mass mailings. It seems that the only limit may be 
your imagination. 


Is SynFilet the pertect program??'? Well, no, 
unfortuneately not.. There are some features not 
available that I miss from Filemanager 806+, such as 
repeating fields. And, when in the "RETRIEVE" mode 
you must push the START button for the next record: 
there is no “automatic” option. It also canbe a pain 
that, after creating and using a “LISTS or “LABELS" 
format, if you go back to “RETRIB VE", perhaps to 
change some data, you must redo you output format. 
Unlike Filemanager 806+, that format is not Kept in 
memory once you leave that section. If you are 
outputting some data and notice, for instance, that 
you found a wrong data item or perhaps forgot a field 
you wanted to output, or need to change ANYTHING, 
yOu must enter all the “LISTS* or “LABELS” format 
information again. (It can be a REAL PAIN). 


So it’s not the perfect program. But, in my humble 
Opinion, it is by far the most advanced am for the 
Atari, bar none. Youcan feel free to disagree with 
that opinion, but until I see some thing better... In 
any Case, it 18a superior program and || recommend it 
highly to anyone who wants a truely good data 
management program. If they were all like this, NO 
ONE would consider the Atari “gst a game machine". 


Not any more. 


WEL, ITS A HIGHLY 


BEING A LAYMAN weCALIT OF 
YOU PROBABLY CAN'T A 


GRIOP EXACTLY 
WHAT IT TOES. 
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ELIMINATING ERROR 168 - 
«Gepted by Kay Maynard Lare¢ 
4-84 
Editor’, note: Ihe following ites was adapted fron bag 


December 1955 issue of = =foaston = btari Conputer 
Eathasiast, Dewsletter. 


Have any of you had Probleas with ERROR 144? This errep 
Says that a “tile nuaber aismatch’ has occurred. Phew 
that happers, you are unable to use that tile any aoe. 
Gary Sewell and Wes Newel] of ACUGD have cose up with @ 
fis. In ATARI DOS there 1s 4 routine that check tee 
file nuaber aisaatches when loading a progras. That 
foutine can be Casily NO-OPed as follows. with the 
BASIC cartridge inserted, boot up the Syste. Then ie 
PORE 4149, 234: POKE 4149, 234 
The "234" is a NO-OF Instruction. Then ge to 0S ord 
mite out the new 00S. You can use this eethed wita 
double-density also. Their final Coaeent is “This patca 


Should have no-side effects with any good ists, so use 
tt on all your dishs.°* 


BACK ISSUES AVAILABLE 


If you are anew member and are missing issue of 


Keeping PACE from before you wined, you can buy 


Copies of back issues at $1.25 each. So, ii you have 
missed Some of the series of articles on Assembly 
Language programming, this is your chance to get a 


full set. Contact the editor, Steve James, for detedie. 


-—_ 
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SynTrend 
BY SYMP, DIK, $69.95 


Reviewed by Allen Hart 


was developed exclusively for Atari by 
san comes on two disks and requires 48K of aeeory 
and BASIC.  SyaTread actually consists of two packages, 
SyaGraph, a flexible graphics package authored by brian 
Lee, and SyaStat, a statistics package authored by Randy 
Lert and Ron Conley. 


SynStat 


Introduction. SyaStatis a eenu driven statistics 
package that allows you to perfora descriptive analysis or 
regression analysis on data that you aay enter via the 
SyaStat editor, or that you aay have created with Syafile, 
SyaCalc, Syabraph, of any program that allows you to store 
data in Data Interchange Foreat (DIF) files. 


If you area statistician, that introduction aay sean 
sosething to you, but if you are not, an attempt is eade 
later in this review to briefly explain what descriptive 
analysis and regression analysis can do for you. 


Data Manipulation. In order to do any statistical 


analysis, you aust first have data to analyze. SyaStat 
provides two ways to enter the data. The first may 18 
with an editor that operates like a spreadsheet (e.g. 
VisiCalc, SyaCalc). The spreadsheet aay contain up to 12 
coluans of nuseric data and a total of 1000 celis. Ihe 
SyaStat editor displays three coluans ata tiee mth 15 
rows in each coluen, and allows you to change the coluans 
and rows that are being displayed, by eoving around 
through the spreadsheet mth the arrow keys. You enter 
data into the spreadsheet by simply aoving to the desired 
cell mith the arrow keys, and typing in the nuaber you 
want. 


The second way to enter data for statistical analysis 
1s by loading data that are stored in DIF files. DIF 
files can be created by SyaCalc, Syafile, Syaéraph, and 
software available froa other eanufacturers. If you have 
data in DIF files, SyaStat provides a comsand that allows 
you to load that data directly into a SyaStat spreadsheet. 


Coluan Calculations. Besides the ability to simply 
enter or load data, SyaStat allows you to perfore 
calcuations on the coluans in a spreadsheet. You can add, 
subtract, aultiply, or divide two coluans, and store the 
result ina third coluen. You can also add a constant to 
a coluan, aultiply a coluan by a constant, or take the 
natural logaritha of all the numbers in a coluan. 


Descriptive Analysis. Once you have a spreadsheet 
filled with data, you are ready to perfora a descriptive 
analysis. SyaStat perfores a descriptive analysis ona 
single variable (coluan of data) in a spreadsheet. After 
you select the desired variable, the results of the 
analysis are provided ina display which contains: 
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- The Muaber of Observations 

~ The Average of all the nuabers in the coluan 

- The Standard Deviation (The average aeount that all 
nuabers deviated froa the average) 

- The Variance (The Standard Deviation Squared.) 

- The Standard Error 

The Maxi aua 

- The Miniaue 

The Range (Maxieue - Rinieua) 


Once the results of the descriptive analysis are 
displayed, you have the option of printing thea by siaply 
pressing the OPTION key. 


Regression Analysis. Before | describe the SyaStat 
Regression Analysis capabilities, | gust eake an adaission 


to all you non-statisticians. | aa not going to try to 
explain in euch detail what regression analysis 15, 
because it has been over ten years since | studied 
statistics. 1 mill briefly describe what capabilities 
SyaStat has, and when possible | will explain what the 
analysis can be used for. If you want to know aore, | 
recosaend (as does the SyaStat docusentation) that you 
reter to a statistics textbook. 


To quote the SyaStat users aanual, “Regression is the 
most comaon statistical technique utilized to contira or 
deny a hypothesis concerning the relationship that exists 
between two or ore variables’. The tutorial on regress- 
ion in the users @anual provides an example that utilizes 
data on a salesaans telephone expenses, autoaobile expens- 
es, and total sales in each aonth. Using regression anal - 
ysis, the tutorial shows that itis possible to decide 
whether the agount of autosobile expenses (travel to see 
custosers), of phone expenses (calis to custoaers) are 
having a @ajor iepact on the asount of sales each eonth. 


Data for regression analysis by SygStat is entered in 
the sage way as data for descriptive analysis, that is via 
the SyaStet editor. In order to perfore the regression 
analysis, you siaply select the variables that you want to 
analyze. SyaStat presents a eenu mith the variables you 
currently have stored in your spreadsheet. First you 
select a single dependent variable (in the exaaple: sales 
for the sonth). Then you aay select froe one to 11 
independent variables. You select the variables by using 
the arrow keys to sove the cursor to the desired variable 
on the senu, thus highlighting the variable nase, and 
pressing the RETURN key. then you have selected all the 
desired variables, pressing the START hey causes SyaStat 
to run the regression analysis. 


After SyaStat has run the reqresson analysis, it allows 
you to view the results on a set of five different 
displays: 


1) Regression Coetticients 

2) Analysis of Variance 

3) Partial Correlation Coefficients Squared 
Dependent Variable with Independent Variables 

4) Correlation Matrix of independent Variables 

5) Residual Analysis 
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The Regression Analysis calculates the equation of a 
curve that fits the data points you have entered for 
analysis. Ihe Cowfficieat display shows the coefficients 
vf the cal-ulated equation as well as a aeasure of how 
well the ejiatior fits the data, The Analysis of Variance 
Provides seasures of Sow well the regressicn exglains ‘he 
gracess fier study ‘e.g., the effect ct the salesean 5 
travel on his sales). The Partial Correlation Coeffic- 
dents are meaningful coly when a aultiple regression aral- 
WSla 15 Core, afd show Dow each independent variable cor- 
re:ates aith the dependent variable hen the atrer inde- 
pensent variebles are held constant. The Residual Anal- 
ySis shows a side dy side Compar:son of the actual depen- 
Gent variabie values, and the predicted values based upon 
the indepencent variables. The Correlation Matrix 91 
Indeoerdent variables shows how the independent variables 
correlate to each other, which is ancther useful analysis 
fool when doing auitiple regressions. 


The SyaStat software is very easy to use, and the 
‘ut orial provides 4 nice introduction to the software. 
for the sore zerious statistician, there is one drawback 
‘nat I noticed. The documentatio- oes sot provide any 
aatnematical dasis for the results that are displayed. | 
Teligve the equatrons tor regression analysis are 
‘easonably standard, but a section of the sequal far 
advanced users that showed the equations that are vseo in 
the SyaStat anaiysis mould nave aeen a nice addition. 


SynGraph 


Introduction. Syaéraph is a vers usetcl an> versatile 
yarhics package that aliows you to produce line graphs, 
bar grapns, ple charts, and scatter plots. Syaérapa 
allams you to fefine aany differant characteristics of 
each of the graphs. It produces the graphs first on the 
computer screen in GRAFHICS 8. It then allows you to 
print the graph (to and Epson or a Prowiter), save ‘ne 
graph wn a) file on disk, or revise soae of the 
Characteristics, and have a new graph displayed. 


MONTH OF 


= 
SCenwheHenare 


Geo ecsctcest 


2 


5 
a 
i. 
C 
% 
“ 
D 


-_- .« 
—=—y+ 


VORITS 


Noveeber, 1984 


cy 


Editor. The editor in Syabraph 1s aucn simpler thas 
the one in SyaStat. The Syeéraph editor Siaply allows you 
to create lor edit! a GIF file. !t disolays a aenu on the 
screen that alloms you to enter nuseric data for a single 
variable, You way enter up to 15 values on each screen, 
and aay tren advance to another screen via the START key. 


The editor allows you to store up to 100 values in a 
siagie DIF tile. 


Selection of Graph Type. In order to select the type 
of Graph ycu want tc produce, you tirst seiect the GRAPH 
DHiA option ch the main menu.  Sypbraph then displays a 
selection seme on the ::ttoa of the screen as shown below: 


Line Graph 
Scatter Fiet 


bar braph 
Fie Cnart 


cOle 


inTA View GRAFH | GRAPH DATA 


Ine highlighted entries in tne senu are actuaily an 
‘everse video on the screen. Using the arrow keys you say 
aove around cr the tenu. When the desired type of graph 
16 highlighted, vo. siaply press RETURN.  Syaéraph then 
lcads the correct prograe tor that type of graph. 


witer you select a type or graph, you are shown a 
sequence of parameter entry screens that allow you to 
cetine {the Characteristics of tne graph you want to 
proguce, The tyces of characteristics yOu @ay specify 
ipcluge the title, the nueber of variables (tactars) to be 
grapned, the labels tc te used on the graph, the files to 
(2 i3e¢ 435 4 data source, the ‘ype of grid to be used cn 
tne graph, scaling irtormation, and a file nase to save 
the aisplay in. 


Line Graphs. A line graph 1s a graph of two variables 
on an x-y chart, with lines connecting each of the points. 


Syp6raph allows you to grapn up to three pairs ai 
rariatles on one graph. Eacn cair ct variables aay consist 
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of up to 100 values each. A set of example graphs, 
produced by the Syaéraph software are showa with this and displays a new paraaeter entry screen which allows you 
review. The first example is a saeple line graph showing to scale your graph. The foraat of the display is shown 
the nuaber of shoppers and the nuaber of sales in a below: 

hypothetical store, from the Bth through the {8th of 
August. 


SyeGraph next reads the data files you have specified, 


LINE GRAPH 
SCALING 


AXIS CURRENT MIN CURRENT MAX 


SyaGraph allows you to define a line graph mith a 
sequence of three paraseter entry displays. A saaple of 
the first display is shown below: 


LINE GRAPH 


DISK DRIVE NUMBER: 


REVISED MIN Y3 
TITLE OF GRAPH: REVISED MAX Y: 
REVISED MIN Xz 
NUMBER OF FACTORS: REVISED MAX X: 


NAMES OF FACTORS: Y DIVISIONS (1-15): 


X DIVISIONS (1-6): 


INTEGER (X,Y,B,N)s 
Y-AXIS LABEL: 
X-AXIS LABEL: 


OPT*=ABORT SLCT=AUTOSCALE START=CONT 


GRID (H,V,B,N)i 
FILE FOR SAVING: 


OPTION=MAIN MENU START=CONTINUE 


You have the option of revising the ainiaua and aaxieue 
scale values that are to be used on the graph, specifying 
the nuaber of divisions you want annotated on each axis, 
and indicating 1f you want the annotations on the x and/or 
y axes to be integers rather that real nuabers. If you 
want, you can have Syaéraph autosatically scale the graph 
for you by simply hitting the SELECT key. 


After you fill in the fields in the first display and 
press START, Syaéraph displays a menu which lists all the 
DIF files on your data disk. Yau are then proepted to 
enter two tile names for each factor you have nased in the 
first parameter entry display. You aust enter a file nase 
tor the x variable, and a file name for the y variable. 


Scatter Plots. Scatter plots are aleost identical to 
line plots, with the single exception that the data points 
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that are plotted on the x-y graph are not connected by 
lines. Scatter plots are created in exactly the same may 
as line graphs. The genus displayed by Syabraph for 
scatter plots are identical to those for line graphs, with 
the single exception of the title line on the aenu. 


Bar Graphs. Bar graphs are very useful graphs that 
allow the comparison of the aagnitudes of two or three 
variables, or the illustration of atrend in a single 
variable. The exaaple graph contains the sae data that 
was used in the line graph example. The exaeple 
deaonstrates one of the two types of bar charts supported 
by the Syaéraph package, stacked bar graphs, and clustered 
bar graphs. 


SyaGraph allows you to produce bar graphs containing up 
to 52 single-tactor bars, 24 two-factor bars, or 14 three- 
factor bers. Clustered bar graphs can display both 
positive and negative values, but stacked bar graphs can 
display only positive values. 


Bar graphs are defined to SyaGraph in alaost the sane 
way as line graphs. The only difference in the first aenu 
1s that bar graphs allow only horizontal grids, so the 
genu does not allow for vertical grids or grids in both 
directions. The data selection senu and scaling senu are 
Similar too, except that you only scale datain the y 
direction for bar graphs. One big difference for bar 
graphs, is the addition of a aenu to defme labels tor 
each of the bars (or clusters of bars). One useful 
application of the labelling is to specify the aonths of 
the year undereach bar. 


Pie Charts. Pie charts are a useful graphing technique 
to show the percentage that each aajor coaponent aakes up 
in a total package. They are used very frequently to show 
hom the aoney in a budget is divided aaong the different 
Components of the budget. A pie chart 1s show in the set 
of exaaple graphs. 


.. _November, 1784 
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SyaGraph will handle pie charts mith up to 12 slices. 
It calculates the percentages to be displayed beside each 
slice, and allows you to enter a label of up to seven 


Characters to be displayed by each slice. 


There are only three menus for the generation of pie 
charts. The first aenu allows you to specify a disk 
drive, aqraph title, and a file to save the display in. 
The second aeny allows you to select the data file to be 
used as the data source. The last senu allows you to 
specify the labeis to be used on each slice or the pie. 


Printing. In addition to displaying the graphs on the 
screen, Syabraph will print the graphs on an EPSON, or a 
PROWKITER. All that 15 required to print the displays is 
to hit the OPTION key, use the arrow keys to select the 
printer type, and hit the RETURN key. Jf you are like ae, 
and you don't have an EPSON, or a PROWRITER, you can still 
get printed copies of the displays, a5 long as you have a 
printer with graphics capability, and a BASIC progras that 
will duap a GRAPHICS 8 screen to your printer. 


Saving. In addition to the ability to print your 
graphs, Syabraph allows you to save a copy of the graph in 
a disk file, and call the graph back up tor later viewing. 


The user anual contains the listing of a prograg that 
will generate a slide show of graphs by reading a pet of 
saved graphs froe the disk and displaying thee the 
screen. If you have a BASIC routine to duap a ICS 8 
screen to your printer, you can aodify the slide show 
progras to first load the displays frow the disk, aad then 
print thea on your printer. | really ae sure you can, 
because that is how the exaaple graphs in this article 
were produced. 


Coac}usions. The Syalread software package 15 a 
professionally produced product. It 15 easy to use, and 
flexible. Both the statistics package and the graphics 
package should prove to be valuable tools for anyone who 
1s interested in data trend analysis. 
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The TRAP command allows you to re-direct program flow in a_ BASIC 
program. It allows you to direct what a program will de when it 
generates a error condition. Take a look at the program below for a 
sample of it’s use: 


Atari Basic’s TRAP Command 
Paul Maternowski HA wKAT AR, 


S DIM LINE$( 7255) 

10 TRAP 1000 

ZO OPEN #1,4,0,"D: FILENAME" 

30 TRAP 2000 

40 INPUT #1, LINES 

50 7? LINES 

60 GOTO 40 
1000 CLOSE #1:7"“Could not find file" 
10206 END 
2000 CLOSE @1:7"File read successfully” 


This program will read the file "D: FILENAME" and print it to mA 
screen. The TRAP instruction in lane 1¢ telle BASIC to goto lane 1000 
on the next error. If line 20 generates a error condition from not 
having the disk with that filename in the drive, a goto line pei 
will be executed telling you that file is not cn the disk. Line 36 
sets the trap to line 2000. Lines 40,50 & 60 will be executed until 
an end-of-file error occurs, at which time a goto line 2000 will be 
executed. The file read successfully message will be pranted to the 


screen. 


The TRAP can be turned off by using 4 TRAP number greater than 


32767. When you typ= in an immediate mode lane such as: 
RUN<RETURN> or 727+2°RETURN> 


you are actually typing in with a line number of 327748. The TRAP 
instruction takes the line number after it and stores it in two bytes 
at locations 188 and 189. When a error occurs if BASIC, it examines 
location 189 to check if the number 15 Jece than 178 which 
corresponds to a line number less than 32768. If the number in this 
location 15 less than 176, BASIC instead of Frinting out ERROR XXX 
etc., will anstead goto the line number stored in locations 1866 and 
189. Once a TRAP is executed, it is cleared and the TRAF anstruction 
must be set again if it is to be reused. 


Et CS Conmmnmector Sourc = 


A good source of ATARI 12 pin 1/9 comunectore i¢©=60ss Ceénturian 
Enterprises at $3.00 apiece. They stock both types, internal and the 
cable end types, along with 4 complete source of parts, kits idl 
software at good discounts. If anterested write fer a catalog: 
P.0O.Box 3233, San Luis Obaspo,CA 93403-3733 


CHAOS 


VISICALC 
QUICKY GUIDE 
by A. Aldrich 


Have you ever been working along with your VISICMC and 
just plain can't remeber how to do soaething. Well 


here's a little quicky quide I've put together. Hope 
you get sowe use out of it. 


1.001 UP PROCEDURE: Boot froe drive #1. Wait 2 


sinutes. 


2.D1SK JMITJALIZATION; Insert dish. Press / S 1 and 
Retura. 


5.CLEAR SPREADSHEET; = / CY 
4.061 SERIALG SCREEN; =/ V 


5. CURSOR MOVEMENTS: Press Control and laverse arrow 
key. 


6.PIRECT CURSOR MOVEMENT; Press > (cell) Return 
(exaaple >83). 


1. PACKSPACE-BACKOUT: Press Backspace @ tines aceded. 
©. QUICK CALCIAATION: Example press 25 #25 ! 


9. ENTER & ADVE: Type in Label or Value and thea CIR 
Arron. 


10.QMTN OPERATORS: Mult - 6, Biv - /, Add - +, Sub - - 
11.DORDERS-LIMITS; Right - 0K254, Botton - A254 


12. LABELS: Type letters or precede label witha ° for 
ather illegal label syabols. Can be as long a8 you 
like. 


13. VALUES-FORMULA; Type Meaber or Foreala or * and cell 
aeee. A+ is needed only if a cellnase will be used for 
the first itee ia the foreula. 


14.Cejis: You can't See! Press +, aove cursor to cell 


you want, press then next operator (exaaple -), seve 
cursor to nest cell, press next operator, etc... 


15.SAVING FILES; Press / S & Type filenase (WC is 
appended. 


16. QLAMK AN ENTRY; Press / B Retura. 
17. .OAD]NG FILES: Press / SL Return. 
18.SCROLL IMG JHRY FILES: Press / SL Right arrow Right 


Arrow etc... 


19. FORMATTING SCREEN DISPLAY: Press / 6 F 1 (Glebel 
Foreat lateger). 


20. FORMATTING SCREEN PISPLAY; Press / 6 F § (Global 
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Foreat is dollars & Ceata). 


21. ADIUST ING COLUM WIDTHS: Press / GC 7 (For coleas 
width of 7). 


a. 
_o. 
€. 


J to 3) width available. 
Can only do globally. 
>) appears if no space between cells. 


d. Labels don’t have this extra space. 


22. SPLITTING THE SCREEN: 


a. 
d. 
te 
d. 
e. 

at.) 


Type DEL (Splits window on the lett of E') 
Type / # 
Type V 


Type ; (To Jusp back & ferth between screeas). 
Type /6C4 (Only attects window where cerser is 


23. Going back to 1 windows Type / wi 


24. SPLIT] IW IME SCREEN: Mer izent all ys 


a. 
b. 
c. 
é. 


be back to | window process. 
Type > B11 
Type / OH 
Type ; (te jemp back & forth) 


75.E101M) TITLES 1 PLACE: 


b. Type / TV CTRL Right arrow (6 tiaes) er Mi 


Weve curser te left edge (en titles Al) 


1. W te fix horizontal titles 
2. V to fix vertical titles 
J. B to fix beth 

4. W te tix neither 


c. Dicell thats a title) te get curser en that cell 
(single curser eeves wea't de it. 


2%. 
4. 


if 
Type /UL/ TMS EF GO / OC 9 retere. 


27.REPL CAT Libis 


La! 
. 


brawing lines across the sheet 
1. Type Ad / - 

2. Type - retura 

J. Type / & retera 

4. Type 83.03 retera 


Replicating auabers & labels: 
1. Type INCOME in A2 

2. Type 1778 in A2 

3. Type / & retera 

4. Type C2.82 retera 


Replicatiag another (jest | line) 
1. Type ia a label at Al 

2. Type a euaber at Bi 

3. Type a ferenla at Ci 

4. Type / Rt retwa 

3. Type 01.81 retere 

6. Type a 


